New-CMTSStepUpgradeOperatingSystem

  • Referenz
Modul:
ConfigurationManager

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.

Type:IResultObject[]
Aliases:Conditions
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortfahren zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.

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

-Description

Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.

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

-Disable

Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.

Type:SwitchParameter
Aliases:DisableThisStep
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

-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.

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.
Type:DynamicUpdateOption
Accepted values:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EditionIndex

Geben Sie einen ganzzahligen Wert der Betriebssystemupgradepaketedition an. Verwenden Sie diesen Parameter mit dem Parameter UpgradePackage .

Type:Int32
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

-IgnoreMessage

Legen Sie diesen Parameter auf fest $true , um anzugeben, dass Windows Setup die Installation abgeschlossen und alle verworfenen Kompatibilitätsmeldungen ignoriert.

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

-Name

Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.

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

-ProductKey

Geben Sie den Product Key an, der auf den Upgradeprozess angewendet werden soll.

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

-ScanOnly

Legen Sie diesen Parameter auf fest $true , um den Windows Setup-Kompatibilitätsscan auszuführen, ohne das Upgrade zu starten.

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

-SetupTimeout

Geben Sie die Anzahl der Minuten an, bevor Configuration Manager diesen Schritt nicht erfolgreich ist. Diese Option ist nützlich, wenn Windows Setup die Verarbeitung beendet, aber nicht beendet.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-SourcePath

Geben Sie einen lokalen oder Netzwerkpfad zu den Windows-Medien an, die Von Windows Setup verwendet werden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_UpgradeOperatingSystemAction WMI-Serverklasse.