Set-CMBootImage

Ändern eines Betriebssystemstartimages.

Syntax

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   -Id <String>
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Betriebssystemstartimage zu ändern. Startimages sind Windows PE-Images (Windows Preinstallation Environment), in denen Sie einen Clientcomputer starten, bevor Sie ein Betriebssystem installieren.

Sie können einem Startimage Gerätetreiber hinzufügen oder dessen Eigenschaften ändern. Bevor Sie einen neuen Gerätetreiber hinzufügen können, müssen Sie zuerst den Treiber in den Configuration Manager Treiberkatalog importieren und aktivieren.

Jede Version von Configuration Manager unterstützt eine bestimmte Version des Windows Assessment and Deployment Kit (Windows ADK). Sie können Startimages verwalten oder anpassen, wenn sie auf einer Windows PE-Version der unterstützten Version von Windows ADK basieren.

Weitere Informationen finden Sie unter Verwalten von Startimages mit Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Umbenennen eines Startimages

Dieser Befehl ruft ein Startimage anhand seiner Paket-ID ab und benennt es dann um.

Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"

Beispiel 2: Festlegen beschreibender Eigenschaften

Dieser Befehl ruft ein Startimage anhand seines Namens ab und fügt ihm dann eine Version und Beschreibung hinzu.

Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"

Beispiel 3: Festlegen des Tastaturlayouts

Im folgenden Beispiel wird das Standardtastataturlayout des Startimages auf die Sprache Russisch (Russland) festgelegt. Das Startabbild wird anhand seiner ID identifiziert.

Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"

Beispiel 4: Hinzufügen optionaler Komponenten

In diesem Beispiel werden die optionalen .NET- und PowerShell-Komponenten abgerufen und dann dem Startimage hinzugefügt.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

Parameter

-AddOptionalComponent

Geben Sie ein Array optionaler Komponentenobjekte an, die dem Startimage hinzugefügt werden sollen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMWinPEOptionalComponentInfo .

Die folgenden Komponenten werden häufig verwendet:

  • Microsoft .NET (WinPE-NetFX): Diese Komponente ist eine Voraussetzung für PowerShell. Es handelt sich um eine der größeren optionalen Komponenten.
  • Windows PowerShell (WinPE-PowerShell): Diese Komponente erfordert .NET und fügt eingeschränkte PowerShell-Unterstützung hinzu. Wenn Sie benutzerdefinierte PowerShell-Skripts während der WinPE-Phase Ihrer Tasksequenz ausführen, fügen Sie diese Komponente hinzu. Es gibt weitere Komponenten, die möglicherweise für andere PowerShell-Cmdlets erforderlich sind.
  • HTML (WinPE-HTA): Wenn Sie benutzerdefinierte HTML-Anwendungen während der WinPE-Phase Ihrer Tasksequenz ausführen, fügen Sie diese Komponente hinzu.

Weitere Informationen finden Sie unter Verwalten von Startimages – optionale Komponenten.

Type:IResultObject[]
Aliases:AddOptionalComponents
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackgroundBitmapPath

Geben Sie den Netzwerkdateipfad einer benutzerdefinierten Hintergrundbilddatei an, die in Windows PE verwendet werden soll.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CopyToPackageShareOnDistributionPoint

Clients können ein Startimage immer von einem Verteilungspunkt herunterladen. Wenn Sie diesen Parameter auf $true festlegen, stellt der Standort ihn über eine benannte Netzwerkfreigabe auf Verteilungspunkten zur Verfügung. Verwenden Sie CustomPackageShareName , um einen benutzerdefinierten Freigabenamen anzugeben.

Wenn Sie diese Option aktivieren, ist mehr Platz auf Verteilungspunkten erforderlich. Sie gilt für alle Verteilungspunkte, an die Sie dieses Startimage verteilen.

Type:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomPackageShareName

Wenn Sie CopyToPackageShareOnDistributionPoint aktivieren, können Sie diesen Parameter verwenden, um den Freigabenamen anzupassen. Die maximale Länge beträgt 127 Zeichen und darf keines der folgenden Zeichen enthalten: " / [ ] : | < > + = ; , ? *. Sie können einen Freigabenamen und einen Ordnernamen angeben, aber dann beträgt der Höchstwert für jede 80 Zeichen. Beispiel: ShareName\FolderName.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployFromPxeDistributionPoint

Legen Sie diesen Parameter auf $true fest, um dieses Startimage über einen PXE-fähigen Verteilungspunkt verfügbar zu machen. Weitere Informationen finden Sie unter Verwenden von PXE zum Bereitstellen von Windows über das Netzwerk.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Geben Sie eine optionale Beschreibung eines Startimages an, damit Sie es leichter identifizieren können.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPoint

Diese Option ist veraltet. Es legt die ForcedDisconnectEnabled-Eigenschaft des Startimages fest.

Type:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPointMins

Diese Option ist veraltet. Es legt die ForcedDisconnectDelay-Eigenschaft des Startimages fest.

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPointRetryCount

Diese Option ist veraltet. Es legt die ForcedDisconnectNumRetries-Eigenschaft des Startimages fest.

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointUpdateSchedule

Verwenden Sie diesen Parameter, um Verteilungspunkte nach einem Zeitplan zu aktualisieren. Verwenden Sie zum Abrufen eines Zeitplanobjekts das Cmdlet New-CMSchedule .

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableBinaryDeltaReplication

Legen Sie diesen Parameter auf $true fest, um die binäre differenzielle Replikation (BDR) zu aktivieren. Weitere Informationen finden Sie unter Grundlegende Konzepte für die Inhaltsverwaltung in Configuration Manager.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableCommandSupport

Nur in Nicht-Produktionsumgebungen können Sie diesen Parameter auf $true festlegen, um die Befehlsunterstützung zu aktivieren. Wenn ein Gerät mit diesem Image startet, können Sie F8 drücken, um eine administrative Eingabeaufforderung zu öffnen. Diese Option ist nützlich für die Problembehandlung, während Sie Ihre Bereitstellung testen. Die Verwendung dieser Einstellung in einer Produktionsbereitstellung wird aus Sicherheitsgründen nicht empfohlen.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnablePrestartCommand

Legen Sie diesen Parameter auf $true fest, um einen Prestart-Befehl zu aktivieren. Diese Befehlszeile wird ausgeführt, bevor die Tasksequenz gestartet wird.

Konfigurieren Sie außerdem die folgenden Parameter: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Führen Sie den Befehl aus, ohne zur Bestätigung zu fragen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Geben Sie eine zu konfigurierende Startimage-ID an. Dieser Wert ist eine Standardpaket-ID, z. B.: XYZ00002.

Type:String
Aliases:PackageId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IncludeFilesForPrestart

Wenn Sie EnablePrestartCommand aktivieren, verwenden Sie diesen Parameter, wenn für den Prestart-Befehl andere Dateien ausgeführt werden müssen. Verwenden Sie dann den Parameter PrestartIncludeFilesDirectory , um den Speicherort der einzuschließden Dateien anzugeben.

Wenn Sie beispielsweise ein Batchskript ausführen möchten, verwenden Sie diese Option, um die Skriptdatei einzuschließen.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputLocale

Verwenden Sie diesen Parameter, um das Standardtastataturlayout für ein Startimage zu konfigurieren. Geben Sie das Sprachtag an. Um beispielsweise das Eingabegebietsschema auf Russisch (Russland) festzulegen, geben Sie die Zeichenfolge ru-ruan. Weitere Informationen finden Sie unter [MS-LCID]: Referenz zu Windows Language Code Identifier (LCID).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Geben Sie ein zu konfigurierende Startimageobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBootImage .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Geben Sie den Namen eines zu konfigurierenden Startimages an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Geben Sie einen neuen Namen für das Startimage an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Geben Sie den Netzwerkpfad des Windows PE-Images an, das dieses Startimage verwendet. Sie können den Pfad für Standardstartimages nicht ändern.

Type:String
Aliases:ImagePath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistContentInCache

Wenn der Inhalt dieses Pakets nicht aus dem Clientcache veraltet sein soll, um Platz für andere Inhalte zu schaffen, legen Sie diesen Parameter auf $true fest, um ihn im Clientcache beizubehalten.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrestageBehavior

Geben Sie das Verhalten an, wenn Sie einen Verteilungspunkt für vorab bereitgestellten Inhalt aktivieren:

  • ManualCopy: Manuelles Kopieren des Inhalts in diesem Paket auf den Verteilungspunkt
  • DownloadDelta: Nur Inhaltsänderungen auf den Verteilungspunkt herunterladen
  • OnDemand: Inhalt automatisch herunterladen, wenn Pakete Verteilungspunkten zugewiesen sind

Weitere Informationen finden Sie unter Verwenden von vorab bereitgestelltem Inhalt.

Type:PrestageBehavior
Accepted values:ManualCopy, DownloadDelta, OnDemand
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrestartCommandLine

Wenn Sie EnablePrestartCommand aktivieren, verwenden Sie diesen Parameter, um die auszuführende Befehlszeile anzugeben. Die maximale Länge beträgt 4096 Zeichen.

Wenn die Befehlszeile Dateien erfordert, die nicht in Windows PE vorhanden sind, verwenden Sie die Parameter IncludeFilesForPrestart und PrestartIncludeFilesDirectory .

Type:String
Aliases:CommandLine
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrestartIncludeFilesDirectory

Wenn Sie EnablePrestartCommand und IncludeFilesForPrestart aktivieren, verwenden Sie diesen Parameter, um den Netzwerkpfad der Dateien anzugeben, die in das Startimage eingeschlossen werden sollen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Priority

Geben Sie die Reihenfolge an, in der der Standort den Inhalt an andere Standorte sendet, und die Verteilungspunkte an diesem Standort.

Die Website sendet Inhalte mit hoher Priorität vor Paketen mit mittlerer oder niedriger Priorität. Pakete mit gleicher Priorität werden in der Reihenfolge gesendet, in der sie erstellt werden.

Type:Priority
Accepted values:High, Medium, Low
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Reload

Gilt für Version 2006 und höher. Wenn die Versionen der Windows ADK-Komponenten im Startimage veraltet sind, fügen Sie diesen Parameter hinzu, um das Startimage mit der aktuellen Windows PE-Version aus dem Windows ADK neu zu laden. Weitere Informationen finden Sie unter Aktualisieren von Verteilungspunkten mit dem Startimage.

Type:SwitchParameter
Aliases:ReloadImage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveOptionalComponent

Geben Sie ein Array optionaler Komponentenobjekte an, die aus dem Startimage entfernt werden sollen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMWinPEOptionalComponentInfo .

Entfernen Sie nicht die folgenden Komponenten, die für Configuration Manager erforderlich sind:

  • Skripterstellung (WinPE-Scripting)
  • Start (WinPE-SecureStartup)
  • Netzwerk (WinPE-WDS-Tools)
  • Skripterstellung (WinPE-WMI)
Type:IResultObject[]
Aliases:RemoveOptionalComponents
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScratchSpace

Konfigurieren Sie den Windows PE-Scratch-Speicherplatz, bei dem es sich um temporären Speicher (RAM-Laufwerk) handelt, der von WinPE verwendet wird. Wenn beispielsweise eine Anwendung innerhalb von WinPE ausgeführt wird und temporäre Dateien schreiben muss, leitet WinPE die Dateien an den Arbeitsspeicherspeicher um, um das Vorhandensein einer Festplatte zu simulieren. Standardmäßig beträgt dieser Wert 512 MB für Geräte mit mehr als 1 GB RAM, andernfalls ist der Standardwert 32 MB.

Type:UInt32
Accepted values:32, 64, 128, 256, 512
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SendToPreferredDistributionPoint

Wenn Sie die bedarfsgesteuerte Inhaltsverteilung an bevorzugte Verteilungspunkte aktivieren möchten, legen Sie diesen Parameter auf $true fest. Wenn Sie diese Einstellung aktivieren und ein Client den Inhalt für das Paket anfordert und der Inhalt auf keinen Verteilungspunkten verfügbar ist, verteilt der Verwaltungspunkt den Inhalt. Weitere Informationen finden Sie unter Bedarfsgesteuerte Inhaltsverteilung.

Type:Boolean
Aliases:SendToPreferredDistributionPoints
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Geben Sie die Version des Startimages an. Dieser Wert ist nicht die Betriebssystemversion, sondern eine von Ihnen verwaltete Zeichenfolge.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object