New-CMTSStepUpgradeOperatingSystem
Erstellen Sie einen Schritt Betriebssystem aktualisieren , den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepUpgradeOperatingSystem
[-DriverPackage <IResultObject>]
[-DynamicUpdateSetting <DynamicUpdateOption>]
[-EditionIndex <Int32>]
[-IgnoreMessage <Boolean>]
[-ProductKey <String>]
[-ScanOnly <Boolean>]
[-SetupTimeout <Int32>]
[-SourcePath <String>]
[-StagedContent <String>]
[-UpgradePackage <IResultObject>]
[-SoftwareUpdate <IResultObject[]>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt ein neues Upgrade-Betriebssystemschrittobjekt . Verwenden Sie dann das Cmdlet Add-CMTaskSequenceStep , um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu Tasksequenzschritten: Upgrade des Betriebssystems.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>
. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
In diesem Beispiel wird zunächst das Cmdlet Get-CMOperatingSystemInstaller verwendet, um ein Objekt für das Betriebssystemupgradepaket abzurufen. Dieses Objekt wird in der variablen $osUpgPkg gespeichert. Im nächsten Schritt wird ein -Objekt für den Schritt Betriebssystem aktualisieren erstellt, wobei das $osUpgPkg -Objekt als Betriebssystemupgradepaket verwendet wird.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.
$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1
$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsUpg | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parameter
-Condition
Geben Sie ein Bedingungsobjekt an, das mit diesem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts eines der Tasksequenzbedingungs-Cmdlets. Beispiel: Get-CMTSStepConditionVariable.
Typ: | IResultObject[] |
Aliase: | Conditions |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortsetzen zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
Typ: | SwitchParameter |
Aliase: | DisableThisStep |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DriverPackage
Geben Sie ein Treiberpaketobjekt an, um den Treiberinhalt während des Upgrades für Windows Setup bereitzustellen. Verwenden Sie zum Abrufen dieses Pakets das Cmdlet Get-CMDriverPackage .
Verwenden Sie den Parameter StagedContent , um den Speicherort für den Treiberinhalt anzugeben.
Typ: | IResultObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DynamicUpdateSetting
Verwenden Sie diesen Parameter, um Windows Setup dynamisch mit Windows Update zu aktualisieren.
-
DisablePolicy
: Dynamisches Update nicht verwenden -
UsingPolicy
: Aktivieren Sie das Setup für die Verwendung dynamischer Updates, z. B. Suchen, Herunterladen und Installieren von Updates. -
OverridePolicy
: Überschreiben Sie vorübergehend die lokale Richtlinie in Echtzeit, um dynamische Updatevorgänge auszuführen. Der Computer erhält Updates von Windows Update.
Typ: | DynamicUpdateOption |
Zulässige Werte: | DisablePolicy, UsingPolicy, OverridePolicy |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EditionIndex
Geben Sie einen ganzzahligen Wert der Betriebssystemupgradepaketedition an. Verwenden Sie diesen Parameter mit dem Parameter UpgradePackage .
Typ: | Int32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-IgnoreMessage
Legen Sie diesen Parameter auf fest $true
, um anzugeben, dass Windows Setup die Installation abgeschlossen und alle verworfenen Kompatibilitätsmeldungen ignoriert.
Typ: | Boolean |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
Typ: | String |
Aliase: | StepName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ProductKey
Geben Sie den Product Key an, der auf den Upgradeprozess angewendet werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ScanOnly
Legen Sie diesen Parameter auf fest $true
, um den Windows Setup-Kompatibilitätsscan auszuführen, ohne das Upgrade zu starten.
Typ: | Boolean |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SetupTimeout
Geben Sie die Anzahl von Minuten an, bevor Configuration Manager bei diesem Schritt fehlschlägt. Diese Option ist nützlich, wenn Windows Setup die Verarbeitung beendet, aber nicht beendet.
Typ: | Int32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdate
Geben Sie ab Version 2107 ein Softwareupdateobjekt an, um das Windows-Betriebssystem eines Clients mithilfe eines Featureupdates zu aktualisieren. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSoftwareUpdate .
Typ: | IResultObject[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SourcePath
Geben Sie einen lokalen oder Netzwerkpfad zu den Windows-Medien an, die Von Windows Setup verwendet werden.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-StagedContent
Verwenden Sie diesen Parameter mit DriverPackage , um den Speicherort für den Treiberinhalt anzugeben. Sie können einen lokalen Ordner, einen Netzwerkpfad oder eine Tasksequenzvariable angeben.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UpgradePackage
Geben Sie ein Betriebssystemupgradepaketobjekt an. Verwenden Sie den EditionIndex-Parameter , um die Edition festzulegen.
Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMOperatingSystemInstaller .
Typ: | IResultObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_UpgradeOperatingSystemAction WMI-Serverklasse.