Get-CMTSStepPartitionDisk

  • Referenz
Modul:
ConfigurationManager

Rufen Sie den Schritt "Format- und Partitionsdatenträger" 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 "Format" und "Partitionsdatenträger" abzurufen. Sie können dieses Objekt für Folgendes verwenden:

Weitere Informationen zu diesem Schritt finden Sie unter "Schritte zur Tasksequenz": Formatieren und Partitionieren des Datenträgers.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Abrufen des Schritts aus einer Tasksequenz

In diesem Beispiel wird zuerst ein Tasksequenzobjekt in der variablen $tsOsd. Anschließend übergibt sie diese Variable als Eingabeobjekt, um den Schritt "Format" und "Partitionsdatenträger" 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 Details der Partitionseinstellung 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 einem anderen Schritt hinzu.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-InputObject

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

Type:IResultObject
Aliases:TaskSequence
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-StepName

Geben Sie den Namen des Schritts "Format and Partition Disk" an, der aus der Tasksequenz abgerufen werden soll.

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

-TaskSequenceId

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

Type:String
Aliases:Id, TaskSequencePackageId
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceName

Geben Sie den Namen der Tasksequenz an, aus der der Schritt "Formatieren" und "Partitionsdatenträger" abgerufen werden soll.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object