New-CMTSPartitionSetting

Module:

ConfigurationManager

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

Syntaxe

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 applet de commande crée un objet de partition de disque à utiliser avec l’étape de séquence de tâches Format et Partitionner le disque . Utilisez cette applet de commande pour définir les paramètres de partition, puis utilisez cet objet avec le paramètre -PartitionSetting des applets de commande New-CMTSStepPartitionDisk ou Set-CMTSStepPartitionDisk .

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

• 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’applet de commande crée un objet de paramètres de partition principale.

Pour plus d’informations, consultez Format et partition du disque : 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 principale Windows

Cet exemple crée des paramètres pour une partition principale Windows 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 de récupération représentant 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 la variable $tsOsd . Il passe ensuite cette variable en tant qu’objet d’entrée pour obtenir l’étape Format et partitionner le disque .

Ensuite, pour afficher les paramètres de la première partition, référencez la propriété Partitions , qui est un tableau d’objets 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]

Vous pouvez utiliser ce processus pour copier les paramètres de partition entre des étapes ou des 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

-Confirm

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

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EnableDriveLetterAssignment

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

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EnableQuickFormat

Définissez ce paramètre sur true pour permettre à Configuration Manager d’effectuer un format rapide de la partition.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IsBootPartition

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

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Spécifiez un nom pour la partition.

Type:	String
Alias:	PartitionName, VolumeName
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionEfi

Ajoutez ce paramètre pour définir le type de partition EFI.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionExtended

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionFileSystem

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

Type:	FileSystemType
Valeurs acceptées:	Ntfs, Fat32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionHidden

Ajoutez ce paramètre pour masquer le type de partition.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionLogical

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionMsr

Ajoutez ce paramètre pour définir le type de partition MSR.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionPrimary

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PartitionRecovery

Ajoutez ce paramètre pour définir le type de partition Recovery.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Size

Spécifiez une valeur entière pour la taille de la partition. Utilisez ce paramètre avec le paramètre -SizeUnit . Si -SizeUnit a la valeur Percent, spécifiez un nombre compris entre 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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeurs acceptées:	MB, GB, Percent
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Variable

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez 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 - Formater et partitionner le disque
• Partitions de disque dur basées sur UEFI/GPT
• Partitions de disque dur bios/MBR