New-CMTSPartitionSetting

Creare un oggetto partizione del disco da utilizzare con il passaggio della sequenza di attività Format e Partition Disk.

Sintassi

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>]

Descrizione

Questo cmdlet crea un oggetto partizione del disco da utilizzare con il passaggio della sequenza di attività Format e Partition Disk. Utilizzare questo cmdlet per definire le impostazioni della partizione e quindi utilizzare tale oggetto con il parametro -PartitionSetting dei cmdlet New-CMTSStepPartitionDisk o Set-CMTSStepPartitionDisk.

È possibile creare i seguenti tipi di oggetti impostazioni di partizione, in base al parametro switch utilizzato con questo cmdlet:

  • PartitionPrimary: Partizione primaria
  • PartitionEfi Partizione EFI
  • PartitionExtended: partizione estesa
  • PartitionHidden: Partizione nascosta
  • PartitionLogical: Partizione logica
  • PartitionMsr: partizione MSR
  • PartitionRecovery: Partizione di ripristino

Se non si specifica un parametro dell'opzione di partizione, il cmdlet crea un oggetto impostazioni di partizione principale.

Per ulteriori informazioni, vedere Format and Partition Disk: Volume.

Esempio

Esempio 1: Creare impostazioni per una partizione EFI

Questo esempio crea impostazioni per una partizione EFI di 500 MB e la salva come variabile partEfi.

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

Esempio 2: Creare impostazioni per una partizione MSR

Questo esempio crea impostazioni per una partizione MSR di 128 MB e la salva come variabile partMsr.

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

Esempio 3: Creare impostazioni per una Windows primaria

In questo esempio vengono create le impostazioni Windows partizione primaria e viene salvato come variabile partWin.

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

Esempio 4: Creare impostazioni per una partizione di ripristino

In questo esempio **** vengono create impostazioni per una partizione di ripristino che rappresenta il 100% dello spazio su disco rimanente e la salva come variabile partMsr.

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

Esempio 5: Visualizzare i dettagli dell'impostazione della partizione per un passaggio

In questo esempio viene innanzitutto ottiene un oggetto sequenza di attività nella $tsOsd variabile. Passa quindi tale variabile come oggetto di input per ottenere il passaggio Format e Partition Disk.

Quindi, per visualizzare le impostazioni della prima partizione, fare riferimento alla proprietà Partitions, che è una matrice di SMS_TaskSequence_PartitionSettings oggetti.

$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]

Puoi usare questo processo per copiare le impostazioni della partizione tra passaggi o sequenze di attività. Salvare questo oggetto impostazioni di partizione come variabile e quindi aggiungerlo a un altro passaggio.

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-EnableDriveLetterAssignment

Impostare questo parametro su true per consentire a Configuration Manager di assegnare una lettera di unità alla partizione.

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

-EnableQuickFormat

Impostare questo parametro su true per consentire a Configuration Manager di eseguire un formato rapido della partizione.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-IsBootPartition

Impostare questo parametro su true per impostare questa partizione come partizione di avvio.

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

-Name

Specificare un nome per la partizione.

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

-PartitionEfi

Aggiungere questo parametro per impostare il tipo di partizione EFI.

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

-PartitionExtended

Aggiungere questo parametro per rendere esteso il tipo di partizione.

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

-PartitionFileSystem

Specificare il file system per formattare la partizione.

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

-PartitionHidden

Aggiungere questo parametro per rendere nascosto il tipo di partizione.

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

-PartitionLogical

Aggiungere questo parametro per rendere logico il tipo di partizione.

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

-PartitionMsr

Aggiungere questo parametro per impostare il tipo di partizione MSR.

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

-PartitionPrimary

Aggiungere questo parametro per rendere primario il tipo di partizione.

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

-PartitionRecovery

Aggiungere questo parametro per rendere il tipo di partizione Recovery.

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

-Size

Specificare un valore intero per le dimensioni della partizione. Utilizzare questo parametro con il parametro -SizeUnit. Se -SizeUnit è , specificare un numero compreso tra Percent 1 e 100 per questo parametro. Se -SizeUnit è MB o , specificare un numero per la dimensione della partizione GB specifica.

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

-SizeUnit

Specificare il tipo di unità per le dimensioni. Utilizzare questo parametro con il parametro -Size.

  • Percent: utilizzare -Size per impostare la partizione su una percentuale di spazio libero rimanente sul disco.

  • MB oppure GB : utilizzare -Size per impostare una dimensione specifica per la partizione.

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

-Variable

Per impostazione predefinita, Configuration Manager assegna la successiva lettera di unità disponibile a questa partizione. Per salvare questa lettera di unità per un utilizzo futuro, imposta una variabile della sequenza di attività personalizzata con questo parametro.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Nessuno

Output

IResultObject

Note

Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_PartitionSettings wmi server.