Freigeben über

Get-CMTSStepPartitionDisk

  • Referenz
Modul:
ConfigurationManager

Rufen Sie den Schritt Datenträger formatieren und partitionieren aus einer bestimmten Tasksequenz ab.

Syntax

Get-CMTSStepPartitionDisk
   [-InputObject] <IResultObject>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CMTSStepPartitionDisk
   [-TaskSequenceId] <String>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CMTSStepPartitionDisk
   [-TaskSequenceName] <String>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Tasksequenzschrittobjekt für eine oder mehrere Instanzen des Schritts Datenträger formatieren und partitionieren abzurufen. Sie können dieses Objekt für Folgendes verwenden:

Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu Tasksequenzschritten: Formatieren und Partitionieren von Datenträgern.

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: Abrufen des Schritts aus einer Tasksequenz

In diesem Beispiel wird zunächst ein Tasksequenzobjekt in der variablen $tsOsd abgerufen. Anschließend wird diese Variable als Eingabeobjekt übergeben, um den Schritt Datenträger formatieren und partitionieren abzurufen.

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

$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk

Beispiel 2: Anzeigen der Partitionseinstellungsdetails für einen Schritt

Dieses Beispiel baut auf dem vorherigen Beispiel auf. Um die ersten Partitionseinstellungen anzuzeigen, verweisen Sie auf die Partitions-Eigenschaft , bei der es sich um ein Array von SMS_TaskSequence_PartitionSettings Objekten handelt.

$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk

$tsStepFormatDisk.Partitions[0]

Sie können diesen Prozess verwenden, um Partitionseinstellungen zwischen Schritten oder Tasksequenzen zu kopieren. Speichern Sie dieses Partitionseinstellungsobjekt als Variable, und fügen Sie es dann einem anderen Schritt hinzu.

Parameter

-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

-InputObject

Geben Sie ein Tasksequenzobjekt an, aus dem der Schritt Datenträger formatieren und partitionieren abgerufen werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMTaskSequence .

Typ:IResultObject
Aliase:TaskSequence
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StepName

Geben Sie den Namen des Schritts Datenträger formatieren und partitionieren an, der von der Tasksequenz abgerufen werden soll.

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

-TaskSequenceId

Geben Sie die Paket-ID der Tasksequenz an, aus der der Schritt Datenträger formatieren und partitionieren abgerufen werden soll. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00858. .

Typ:String
Aliase:Id, TaskSequencePackageId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TaskSequenceName

Geben Sie den Namen der Tasksequenz an, aus der der Schritt Datenträger formatieren und partitionieren abgerufen werden soll.

Typ:String
Position:0
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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object