New-CMTSPartitionSetting

Modul:

ConfigurationManager

Erstellen Sie ein Datenträgerpartitionsobjekt, das mit dem Tasksequenzschritt Datenträger formatieren und partitionieren 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

Dieses Cmdlet erstellt ein Datenträgerpartitionsobjekt, das mit dem Tasksequenzschritt Datenträger formatieren und partitionieren verwendet werden soll. Verwenden Sie dieses Cmdlet, um die Partitionseinstellungen zu definieren, und verwenden Sie dieses Objekt dann mit dem Parameter -PartitionSetting des New-CMTSStepPartitionDisk- oder Set-CMTSStepPartitionDisk-Cmdlets .

Sie können die folgenden Typen von Partitionseinstellungsobjekten basierend auf dem switch-Parameter erstellen, den Sie mit diesem Cmdlet verwenden:

• PartitionPrimary: Primäre Partition
• PartitionEfi EFI-Partition
• PartitionExtended: Erweiterte Partition
• PartitionHidden: Ausgeblendete Partition
• PartitionLogical: Logische Partition
• PartitionMsr: MSR-Partition
• PartitionRecovery: Wiederherstellungspartition

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

Weitere Informationen finden Sie unter Format and Partition Disk: Volume.For more information, see Format and Partition Disk: Volume.

Beispiele

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

In diesem Beispiel werden Einstellungen für eine EFI-Partition mit 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 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 primäre Windows-Partition

In diesem Beispiel werden Einstellungen für eine primäre Windows-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 diese als partMsr-Variable gespeichert.

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

Beispiel 5: Anzeigen der Partitionseinstellungsdetails für einen Schritt

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.

Um dann die ersten Partitionseinstellungen anzuzeigen, verweisen Sie 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 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

-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

-EnableDriveLetterAssignment

Legen Sie diesen Parameter auf fest true , damit Configuration Manager der Partition einen Laufwerkbuchstaben zuweisen kann.

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

-EnableQuickFormat

Legen Sie diesen Parameter auf fest true , damit Configuration Manager die Partition schnell formatieren kann.

Typ:	Boolean
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

-IsBootPartition

Legen Sie diesen Parameter auf fest true , um diese Partition zur Startpartition zu machen.

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

-Name

Geben Sie einen Namen für die Partition an.

Typ:	String
Aliase:	PartitionName, VolumeName
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionEfi

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionExtended

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionFileSystem

Geben Sie das Dateisystem zum Formatieren der Partition an.

Typ:	FileSystemType
Zulässige Werte:	Ntfs, Fat32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionHidden

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionLogical

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionMsr

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionPrimary

Fügen Sie diesen Parameter hinzu, um den Partitionstyp Primär zu machen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartitionRecovery

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 ist Percent, geben Sie eine Zahl zwischen 1 und 100 für diesen Parameter an. Wenn -SizeUnit oder GBistMB, geben Sie eine Zahl für die spezifische Partitionsgröße an.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SizeUnitType
Zulässige Werte:	MB, GB, Percent
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
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

None

Ausgaben

IResultObject

Hinweise

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

Ä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