Freigeben über

New-CMTSStepApplyOperatingSystem

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie einen Schritt Betriebssystemimage anwenden , den Sie einer Tasksequenz hinzufügen können.

Syntax

New-CMTSStepApplyOperatingSystem
   [-ConfigFileName <String>]
   [-ConfigFilePackage <IResultObject>]
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-LayeredDriver <OsdLayeredDriver>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   [-ImagePackage <IResultObject>]
   [-ImagePackageIndex <Int32>]
   [-InstallPackage <IResultObject>]
   [-InstallPackageIndex <Int32>]
   [-RunFromNet <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Mit diesem Cmdlet wird ein neues Schrittobjekt vom Typ Betriebssystemimage anwenden erstellt. 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: Anwenden eines Betriebssystemimages.

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-CMOperatingSystemImage verwendet, um ein Objekt für das Betriebssystemimagepaket abzurufen. Dieses Objekt wird in der variablen $osImgPkg gespeichert. Im nächsten Schritt wird ein -Objekt für den Schritt Betriebssystemimage anwenden erstellt, wobei das $osImgPkg-Objekt als Imagepaket verwendet wird.

Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.

$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | 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

-ConfigFileName

Geben Sie den Dateinamen einer unbeaufsichtigten oder Sysprep-Antwortdatei an, die für eine benutzerdefinierte Installation verwendet werden soll. Verwenden Sie diesen Parameter mit dem ConfigFilePackage-Parameter .

Typ:String
Aliase:AnswerFileName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConfigFilePackage

Geben Sie ein Paketobjekt an, das die unbeaufsichtigte Oder Sysprep-Antwortdatei enthält, die für eine benutzerdefinierte Installation verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMPackage . Verwenden Sie diesen Parameter mit dem ConfigFileName-Parameter .

Typ:IResultObject
Aliase:AnswerFilePackage
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

-Destination

Geben Sie den Speicherort an, an dem Sie dieses Betriebssystem anwenden möchten. Wenn Sie diesen Parameter nicht angeben, ist NextAvailableFormattedPartitionder Standardwert .

  • NextAvailableFormattedPartition: Verwenden Sie die nächste sequenzielle Partition, die nicht bereits in den Schritten Betriebssystem anwenden oder Datenimage anwenden in dieser Tasksequenz verwendet wird.

  • SpecificDiskAndPartition: Geben Sie die Datenträgernummer mit dem Parameter DestinationDisk und die Partitionsnummer mit dem Parameter DestinationPartition an.

  • SpecificLogicalDriverLetter: Verwenden Sie den Parameter DestinationDriveLetter , um den logischen Laufwerkbuchstaben anzugeben, der der Partition von Windows PE zugewiesen ist. Dieser Laufwerkbuchstabe kann sich von dem Laufwerkbuchstaben unterscheiden, der vom neu bereitgestellten Betriebssystem zugewiesen wird.

  • LogicalDriverLetterInVariable: Verwenden Sie den Parameter DestinationVariable , um die Tasksequenzvariable anzugeben, die den Laufwerkbuchstaben enthält, der der Partition von Windows PE zugewiesen wurde. Diese Variable wird in der Regel mit dem DiskNumberVariable-Parameter des Cmdlets Set-CMTSStepPartitionDisk oder New-CMTSStepPartitionDisk für den Tasksequenzschritt Datenträger formatieren und partitionieren festgelegt.

Typ:DestinationType
Zulässige Werte:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationDisk

Wenn Sie verwenden -Destination SpecificDiskAndPartition, verwenden Sie diesen Parameter, um die Datenträgernummer anzugeben. Geben Sie eine ganze Zahl von bis 0 an 99. Verwenden Sie auch den Parameter DestinationPartition .

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationDriveLetter

Wenn Sie verwenden -Destination SpecificLogicalDriverLetter, verwenden Sie diesen Parameter, um den Buchstaben des logischen Laufwerks anzugeben. Geben Sie einen Laufwerkbuchstaben von bis C an Zan.

Typ:String
Aliase:DestinationLogicalDrive
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationPartition

Wenn Sie verwenden -Destination SpecificDiskAndPartition, verwenden Sie diesen Parameter, um die Partitionsnummer anzugeben. Geben Sie eine ganze Zahl von bis 1 an 99. Verwenden Sie auch den Parameter DestinationDisk .

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationVariable

Wenn Sie verwenden -Destination LogicalDriverLetterInVariable, verwenden Sie diesen Parameter, um die Tasksequenzvariable mit dem Buchstaben des logischen Laufwerks anzugeben. Der Variablenname muss alphanumerisch ohne Leerzeichen und weniger als 256 Zeichen sein.

Typ:String
Aliase:DestinationVariableName
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

-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

-ImagePackage

Geben Sie ein Betriebssystemimagepaketobjekt an. Der Schritt wendet das Betriebssystem aus diesem Image an. Verwenden Sie den Parameter ImagePackageIndex , um den Bildindex festzulegen.

Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMOperatingSystemImage .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImagePackageIndex

Geben Sie einen ganzzahligen Wert des Bildindexes an. Verwenden Sie diesen Parameter mit dem ImagePackage-Parameter .

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallPackage

Geben Sie ein Betriebssystemupgradepaketobjekt an. Der Schritt wendet das Betriebssystem aus dieser ursprünglichen Installationsquelle an. Verwenden Sie den Parameter InstallPackageIndex , um die Edition festzulegen.

Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMOperatingSystemInstaller .

Typ:IResultObject
Aliase:UpgradePackage
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallPackageIndex

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

Typ:Int32
Aliase:UpgradePackageIndex
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LayeredDriver

Verwenden Sie ab Version 2107 diesen Parameter, um andere Tastaturtypen auszuwählen, die in japanischen und koreanischen Sprachen üblich sind. Geben Sie einen ganzzahligen Wert für den Mehrschichttreiber an, der mit Windows installiert werden soll. Verwenden Sie die gleichen Werte wie die Tasksequenzvariable OsdLayeredDriver .

Typ:OsdLayeredDriver
Aliase:KeyboardDriver
Zulässige Werte:DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
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

-RunFromNet

Legen Sie diesen Parameter auf fest $true , damit die Tasksequenz das Betriebssystemimage direkt vom Verteilungspunkt anwenden kann.

Aus Sicherheitsgründen wird empfohlen, diese Einstellung nicht zu aktivieren. Diese Option ist für die Verwendung auf Geräten mit begrenzter Speicherkapazität konzipiert. Weitere Informationen finden Sie unter Zugreifen auf Inhalte direkt vom Verteilungspunkt aus.

Typ:Boolean
Aliase:AllowAccessFromDistributionPoint
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_ApplyOperatingSystemAction WMI-Serverklasse.