New-CMTSStepApplyDataImage
Erstellen Sie einen Schritt Datenimage anwenden , den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepApplyDataImage
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
-ImagePackage <IResultObject>
-ImagePackageIndex <Int32>
[-WipePartition <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt ein neues Apply Data Image-Schrittobjekt . 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 Datenimages.
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 Datenimagepaket abzurufen. Dieses Objekt wird in der variablen $pkgDataImg gespeichert. Im nächsten Schritt wird ein -Objekt für den Schritt Datenbild anwenden erstellt, wobei das $pkgDataImg-Objekt als Bildpaket verwendet wird.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.
$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1
$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast
$ts | 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 |
-Destination
Geben Sie den Speicherort an, an dem Sie dieses Datenbild anwenden möchten. Wenn Sie diesen Parameter nicht angeben, ist NextAvailableFormattedPartition
der 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 Z
an.
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 Datenbildpaketobjekt an. Der Schritt wendet die Daten aus diesem Bild 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: | True |
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: | True |
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 |
-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 |
-WipePartition
Diese Einstellung ist standardmäßig aktiviert, wodurch alle Inhalte auf der Partition gelöscht werden, bevor das Image angewendet wird.
Legen Sie diesen Parameter auf fest $false
, um den vorherigen Inhalt der Partition nicht zu löschen. Diese Aktion kann verwendet werden, um weitere Inhalte auf eine zuvor zielorientierte Partition anzuwenden.
Typ: | Boolean |
Aliase: | WipePartitionBeforeApplyImage |
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_ApplyDataImageAction WMI-Serverklasse.