Freigeben über

New-CMTSStepApplyDataImage

  • Referenz
Modul:
ConfigurationManager

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