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