New-CMTSPartitionSetting

Создайте объект раздела диска для использования с помощью шага по последовательности задач Format и Partition Disk.

Синтаксис

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

Описание

Этот комлет создает объект раздела диска для использования с помощью шага последовательность задач Формат и Диск раздела. Используйте этот кодлет для определения параметров разделов, а затем используйте этот объект с параметром -PartitionSetting для cmdlets New-CMTSStepPartitionDisk или Set-CMTSStepPartitionDisk.

Можно создать следующие типы объектов параметров разделов на основе параметра коммутатора, используемого с помощью этого коммутатора:

  • PartitionPrimary: Основной раздел
  • PartitionEfi Раздел EFI
  • PartitionExtended: Расширенный раздел
  • PartitionHidden: Скрытый раздел
  • PartitionLogical: Логический раздел
  • PartitionMsr: раздел MSR
  • PartitionRecovery: Раздел восстановления

Если не указать параметр переключения разделов, то этот объект создает основной объект параметров раздела.

Дополнительные сведения см. в разделах Format and Partition Disk: Volume.

Примеры

Пример 1. Создание параметров раздела EFI

В этом примере создаются параметры раздела EFI, который составляет 500 МБ, и сохраняет его в качестве переменной partEfi.

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

Пример 2. Создание параметров раздела MSR

В этом примере создаются параметры раздела MSR с 128 МБ и сохраняется в качестве переменной partMsr.

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

Пример 3. Создание параметров для Windows основного раздела

В этом примере создаются параметры для основного раздела Windows и сохраняется в качестве переменной partWin.

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

Пример 4. Создание параметров раздела восстановления

В этом примере создаются параметры раздела Recovery, который составляет 100% оставшегося дискового пространства, и сохраняет его в качестве переменной partMsr.

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

Пример 5. Просмотр сведений о параметре раздела для шага

В этом примере сначала получается объект последовательности задач в переменной $tsOsd задачи. Затем она передает эту переменную в качестве объекта ввода для получения шага "Диск формата" и "Раздел".

Затем для просмотра первых параметров раздела со ссылкой на свойство Partitions, которое является массивом 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]

Этот процесс можно использовать для копирования параметров раздела между шагами или последовательностями задач. Сохраните этот объект параметры раздела в качестве переменной, а затем добавьте его на другой шаг.

Параметры

-Confirm

Перед запуском командлет запросит подтверждение.

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

-DisableWildcardHandling

Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.

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

-EnableDriveLetterAssignment

Установите этот параметр, true чтобы диспетчер конфигурации назначит разделу букву диска.

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

-EnableQuickFormat

Установите этот true параметр, чтобы диспетчер конфигурации быстро в формате раздела.

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

-ForceWildcardHandling

Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.

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

-IsBootPartition

Установите этот true параметр, чтобы сделать этот раздел разделом загрузки.

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

-Name

Укажите имя раздела.

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

-PartitionEfi

Добавьте этот параметр, чтобы сделать тип раздела EFI.

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

-PartitionExtended

Добавьте этот параметр, чтобы сделать тип раздела Расширенным.

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

-PartitionFileSystem

Укажите файловую систему для формата раздела.

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

-PartitionHidden

Добавьте этот параметр, чтобы сделать тип раздела скрытым.

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

-PartitionLogical

Добавьте этот параметр, чтобы сделать тип раздела логичным.

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

-PartitionMsr

Добавьте этот параметр, чтобы сделать тип раздела MSR.

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

-PartitionPrimary

Добавьте этот параметр, чтобы сделать тип раздела Primary.

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

-PartitionRecovery

Добавьте этот параметр, чтобы сделать тип раздела Восстановление.

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

-Size

Укажите значение integer для размера раздела. Используйте этот параметр с параметром -SizeUnit. Если -SizeUnit Percent есть, укажите номер между 1-100 для этого параметра. Если -SizeUnit MB есть или , GB укажите номер для определенного размера раздела.

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

-SizeUnit

Укажите тип единицы для размера. Используйте этот параметр с параметром -Size.

  • Percent: Используйте -Size, чтобы установить раздел в процентах от оставшегося свободного пространства на диске.

  • MB или. GB Используйте -Size для набора определенного размера раздела.

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

-Variable

По умолчанию диспетчер конфигурации назначает следующее доступное письмо диска этому разделу. Чтобы сохранить это письмо диска для будущего использования, установите настраиваемую переменную последовательности задач с этим параметром.

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

-WhatIf

Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.

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

Входные данные

Нет

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в SMS_TaskSequence_PartitionSettings класса WMI сервера.