New-CMTSPartitionSetting

Module:

ConfigurationManager

Créez un objet de partition de disque à utiliser à l’étape de séquence de tâches Format et Partition Disk.

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

Description

Cette cmdlet crée un objet de partition de disque à utiliser avec l’étape de séquence de tâches Format et Partition Disk. Utilisez cette cmdlet pour définir les paramètres de partition, puis utilisez cet objet avec le paramètre -PartitionSetting des cmdlets New-CMTSStepPartitionDisk ou Set-CMTSStepPartitionDisk.

Vous pouvez créer les types suivants d’objets de paramètres de partition, en fonction du paramètre de commutateur que vous utilisez avec cette cmdlet :

• PartitionPrimary: partition principale
• PartitionEfi Partition EFI
• PartitionExtended : partition étendue
• PartitionHidden : partition masquée
• PartitionLogical: partition logique
• PartitionMsr : partition MSR
• PartitionRecovery : partition de récupération

Si vous ne spécifiez pas de paramètre de commutateur de partition, l’cmdlet crée un objet de paramètres de partition principale.

Pour plus d’informations, voir Format et disque de partition : Volume.

Exemples

Exemple 1 : créer des paramètres pour une partition EFI

Cet exemple crée des paramètres pour une partition EFI de 500 Mo et l’enregistre en tant que variable partEfi.

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

Exemple 2 : Créer des paramètres pour une partition MSR

Cet exemple crée des paramètres pour une partition MSR de 128 Mo et l’enregistre en tant que variable partMsr.

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

Exemple 3 : Créer des paramètres pour une partition Windows principale

Cet exemple crée les paramètres d’Windows partition principale et l’enregistre en tant que variable partWin.

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

Exemple 4 : Créer des paramètres pour une partition de récupération

Cet exemple crée des paramètres pour une partition recovery qui est à 100 % de l’espace disque restant et l’enregistre en tant que variable partMsr.

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

Exemple 5 : afficher les détails du paramètre de partition pour une étape

Cet exemple obtient d’abord un objet de séquence de tâches dans $tsOsd variable. Il transmet ensuite cette variable en tant qu’objet d’entrée pour obtenir l’étape Format et Partition Disk.

Ensuite, pour afficher les premiers paramètres de partition, référencez la propriété Partitions, qui est un tableau de SMS_TaskSequence_PartitionSettings objets.

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

Vous pouvez utiliser ce processus pour copier les paramètres de partition entre les étapes ou les séquences de tâches. Enregistrez cet objet de paramètres de partition en tant que variable, puis ajoutez-le à une autre étape.

Paramètres

- Confirmer

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-EnableDriveLetterAssignment

Définissez ce paramètre true pour laisser Configuration Manager affecter une lettre de lecteur à la partition.

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

-EnableQuickFormat

Définissez ce paramètre true pour laisser Configuration Manager mettre en forme rapidement la partition.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-IsBootPartition

Définissez ce paramètre true pour que cette partition soit la partition de démarrage.

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

-Name

Spécifiez un nom pour la partition.

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

-PartitionEfi

Ajoutez ce paramètre pour que le type de partition EFI.

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

-PartitionExtended

Ajoutez ce paramètre pour étendre le type departition.

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

-PartitionFileSystem

Spécifiez le système de fichiers pour mettre en forme la partition.

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

-PartitionHidden

Ajoutez ce paramètre pour que le type de partition soit masqué.

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

-PartitionLogical

Ajoutez ce paramètre pour rendre le type de partition logique.

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

-PartitionMsr

Ajoutez ce paramètre pour que le type de partition MSR.

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

-PartitionPrimary

Ajoutez ce paramètre pour rendre le type de partition Primary.

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

-PartitionRecovery

Ajoutez ce paramètre pour effectuer la récupération dutype de partition.

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

-Size

Spécifiez une valeur d’un nombre integer pour la taille de la partition. Utilisez ce paramètre avec le paramètre -SizeUnit. Si -SizeUnit est , spécifiez un nombre entre Percent 1 et 100 pour ce paramètre. Si -SizeUnit est MB ou , GB spécifiez un nombre pour la taille de partition spécifique.

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

-SizeUnit

Spécifiez le type d’unité pour la taille. Utilisez ce paramètre avec le paramètre -Size.

• Percent: utilisez -Size pour définir la partition sur un pourcentage d’espace libre restant sur le disque.

• MB ou GB : utilisez -Size pour définir une taille spécifique pour la partition.

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

-Variable

Par défaut, Configuration Manager affecte la lettre de lecteur disponible suivante à cette partition. Pour enregistrer cette lettre de lecteur pour une utilisation ultérieure, définissez une variable de séquence de tâches personnalisée avec ce paramètre.

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

Entrées

Néant

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_TaskSequence_PartitionSettings classe WMI du serveur.

Liens associés

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• À propos des étapes de séquence de tâches : format et disque de partition
• Partitions de disque dur basées sur UEFI/GPT
• Partitions de disque dur BIOS/MBR