New-CMTSPartitionSetting

  • Riferimento
Modulo:
ConfigurationManager

Creare un oggetto partizione del disco da usare con il passaggio della sequenza di attività Formato e disco di partizione .

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 usare con il passaggio della sequenza di attività Formato e disco di partizione . Usare questo cmdlet per definire le impostazioni di partizione e quindi usare tale oggetto con il parametro -PartitionSetting dei cmdlet New-CMTSStepPartitionDisk o Set-CMTSStepPartitionDisk .

È possibile creare i tipi di oggetti impostazioni di partizione seguenti, in base al parametro switch usato 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 di opzione di partizione, il cmdlet crea un oggetto impostazioni della partizione primaria.

Per altre informazioni, vedere Formato e disco di partizione: volume.

Esempio

Esempio 1: Creare impostazioni per una partizione EFI

Questo esempio crea le 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 le impostazioni per una partizione MSR

Questo esempio crea le 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 partizione primaria di Windows

Questo esempio crea le impostazioni per una partizione primaria di Windows e la salva 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

Questo esempio crea le impostazioni per una partizione di ripristino che corrisponde al 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 ottenuto un oggetto sequenza di attività nella variabile $tsOsd . Passa quindi la variabile come oggetto di input per ottenere il passaggio Formato e Disco di partizione .

Per visualizzare quindi le impostazioni della prima partizione, fare riferimento alla proprietà Partitions , ovvero una matrice di oggetti SMS_TaskSequence_PartitionSettings .

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

È possibile usare questo processo per copiare le impostazioni di 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.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableDriveLetterAssignment

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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableQuickFormat

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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IsBootPartition

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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome per la partizione.

Tipo:String
Alias:PartitionName, VolumeName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionEfi

Aggiungere questo parametro per rendere il tipo di partizione EFI.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionExtended

Aggiungere questo parametro per rendere esteso il tipo di partizione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionFileSystem

Specificare il file system per formattare la partizione.

Tipo:FileSystemType
Valori accettati:Ntfs, Fat32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionHidden

Aggiungere questo parametro per rendere nascosto il tipo di partizione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionLogical

Aggiungere questo parametro per rendere logico il tipo di partizione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionMsr

Aggiungere questo parametro per impostare il tipo di partizione MSR.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionPrimary

Aggiungere questo parametro per impostare il tipo di partizione Primario.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionRecovery

Aggiungere questo parametro per impostare il tipo di partizione Recovery.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Size

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SizeUnit

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

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

  • MB o GB: usare -Size per impostare una dimensione specifica per la partizione.

Tipo:SizeUnitType
Valori accettati:MB, GB, Percent
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 uso futuro, impostare una variabile della sequenza di attività personalizzata con questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_PartitionSettings classe WMI del server.