New-CMTSPartitionSetting

Modul:

ConfigurationManager

Erstellen Sie ein Datenträgerpartitionsobjekt, das mit dem Tasksequenzschritt "Format" und "Partition Disk" verwendet werden soll.

Syntax

New-CMTSPartitionSetting
   [-EnableDriveLetterAssignment <Boolean>]
   [-EnableQuickFormat <Boolean>]
   [-IsBootPartition <Boolean>]
   [-Name <String>]
   [-PartitionFileSystem <FileSystemType>]
   [-PartitionPrimary]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-Variable <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionEfi]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionExtended]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionHidden]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionLogical]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionMsr]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionRecovery]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Mit diesem Cmdlet wird ein Datenträgerpartitionsobjekt erstellt, das mit dem Tasksequenzschritt "Format" und "Partitionsdatenträger" verwendet werden soll. Verwenden Sie dieses Cmdlet, um die Partitionseinstellungen zu definieren, und verwenden Sie dieses Objekt dann mit dem Parameter "-PartitionSetting" der Cmdlets "New-CMTSStepPartitionDisk" oder "Set-CMTSStepPartitionDisk".

Sie können die folgenden Arten von Partitionseinstellungsobjekten erstellen, basierend auf dem Switchparameter, den Sie mit diesem Cmdlet verwenden:

• PartitionPrimary: Primäre Partition
• PartitionEfi EFI-Partition
• PartitionExtended: Erweiterte Partition
• PartitionHidden: AusgeblendetePartition
• PartitionLogical: Logical partition
• PartitionMsr: MSR-Partition
• PartitionRecovery: Wiederherstellungspartition

Wenn Sie keinen Partitionsschalterparameter angeben, erstellt das Cmdlet ein primäres Partitionseinstellungsobjekt.

Weitere Informationen finden Sie unter Format- und Partitionsdatenträger: Volume.

Beispiele

Beispiel 1: Erstellen von Einstellungen für eine EFI-Partition

In diesem Beispiel werden Einstellungen für eine EFI-Partition mit einer Größe von 500 MB erstellt und als partEfi-Variable gespeichert.

$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB

Beispiel 2: Erstellen von Einstellungen für eine MSR-Partition

In diesem Beispiel werden Einstellungen für eine MSR-Partition mit einer Größe von 128 MB erstellt und als partMsr-Variable gespeichert.

$partMsr = New-CMTSPartitionSetting -Name "MSR" -PartitionMsr -Size 128 -SizeUnit MB

Beispiel 3: Erstellen von Einstellungen für eine Windows primäre Partition

In diesem Beispiel werden Einstellungen für eine Windows primäre Partition erstellt und als partWin-Variable gespeichert.

$partWin = New-CMTSPartitionSetting -Name "Windows" -PartitionPrimary -Size 99 -SizeUnit Percent -EnableDriveLetterAssignment $true -EnableQuickFormat $true -PartitionFileSystem NTFS -IsBootPartition $true

Beispiel 4: Erstellen von Einstellungen für eine Wiederherstellungspartition

In diesem Beispiel werden Einstellungen für eine Wiederherstellungspartition erstellt, die 100 % des verbleibenden Speicherplatzes beträgt, und es wird als partMsr-Variable gespeichert.

$partRec = New-CMTSPartitionSetting -Name "Recovery" -PartitionRecovery -Size 100 -SizeUnit Percent

Beispiel 5: Anzeigen der Details der Partitionseinstellung für einen Schritt

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.

Verweisen Sie dann zum Anzeigen der ersten Partitionseinstellungen auf die Partitions-Eigenschaft, bei der es sich um ein Array von SMS_TaskSequence_PartitionSettings-Objekten handelt.

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

$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-EnableDriveLetterAssignment

Legen Sie diesen Parameter so true fest, dass Configuration Manager der Partition einen Laufwerkbuchstaben zuweist.

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

-EnableQuickFormat

Legen Sie diesen Parameter so true fest, dass Configuration Manager ein schnelles Format der Partition ausführen kann.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-IsBootPartition

Legen Sie diesen Parameter so true fest, dass diese Partition zur Startpartition wird.

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

-Name

Geben Sie einen Namen für die Partition an.

Type:	String
Aliases:	PartitionName, VolumeName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionEfi

Fügen Sie diesen Parameter hinzu, um den Partitionstyp EFIzu erstellen.

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

-PartitionExtended

Fügen Sie diesen Parameter hinzu, um den Partitionstyp erweitertzu machen.

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

-PartitionFileSystem

Geben Sie das Dateisystem an, um die Partition zu formatieren.

Type:	FileSystemType
Accepted values:	Ntfs, Fat32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionHidden

Fügen Sie diesen Parameter hinzu, um den Partitionstyp ausgeblendetzu machen.

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

-PartitionLogical

Fügen Sie diesen Parameter hinzu, um den Partitionstyp logischzu machen.

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

-PartitionMsr

Fügen Sie diesen Parameter hinzu, um den Partitionstyp MSR zu erstellen.

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

-PartitionPrimary

Fügen Sie diesen Parameter hinzu, um den Partitionstyp "Primary" zu erstellen.

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

-PartitionRecovery

Fügen Sie diesen Parameter hinzu, um den Partitionstyp "Wiederherstellung" zu erstellen.

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

-Size

Geben Sie einen ganzzahligen Wert für die Größe der Partition an. Verwenden Sie diesen Parameter mit dem Parameter "-SizeUnit". Wenn -SizeUnit Percent ist, geben Sie für diesen Parameter eine Zahl zwischen 1 und 100 an. Wenn -SizeUnit oder MB GB -SizeUnit ist, geben Sie eine Zahl für die jeweilige Partitionsgröße an.

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

-SizeUnit

Geben Sie den Einheitentyp für die Größe an. Verwenden Sie diesen Parameter mit dem Parameter "-Size".

• Percent: Verwenden Sie "-Size", um die Partition auf einen Prozentsatz des verbleibenden freien Speicherplatzes auf dem Datenträger festzulegen.

• MB oder: GB Verwenden Sie "-Size", um eine bestimmte Größe für die Partition festzulegen.

Type:	SizeUnitType
Accepted values:	MB, GB, Percent
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

Standardmäßig weist Configuration Manager dieser Partition den nächsten verfügbaren Laufwerkbuchstaben zu. Um diesen Laufwerkbuchstaben für die zukünftige Verwendung zu speichern, legen Sie eine benutzerdefinierte Tasksequenzvariable mit diesem Parameter fest.

Type:	String
Position:	Named
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

Keine

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_PartitionSettings Server-WMI-Klasse.

Ähnliche Themen

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• Informationen zu Tasksequenzschritten - Formatieren und Partitionieren des Datenträgers
• UEFI/GPT-basierte Festplattenpartitionen
• BIOS/MBR-basierte Festplattenpartitionen