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