New-CMTSPartitionSetting

Модуль:

ConfigurationManager

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

Синтаксис

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 командлетов New-CMTSStepPartitionDisk или Set-CMTSStepPartitionDisk .

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

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

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

Дополнительные сведения см. в разделе Формат и секционирование диска: том.

Примеры

Пример 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. Создание параметров для секции восстановления

В этом примере создаются параметры для секции восстановления , которая занимает 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

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableDriveLetterAssignment

Присвойте этому параметру значение , true чтобы разрешить Configuration Manager назначить секции букву диска.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableQuickFormat

Присвойте этому параметру значение , true чтобы разрешить Configuration Manager быстро форматировать секцию.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IsBootPartition

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

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Укажите имя секции.

Тип:	String
Aliases:	PartitionName, VolumeName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionEfi

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionExtended

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionFileSystem

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

Тип:	FileSystemType
Допустимые значения:	Ntfs, Fat32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionHidden

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionLogical

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionMsr

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionPrimary

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PartitionRecovery

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Size

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SizeUnit

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

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

• MB или GB: используйте параметр -Size , чтобы задать определенный размер для секции.

Тип:	SizeUnitType
Допустимые значения:	MB, GB, Percent
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Variable

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

None

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

IResultObject

Примечания

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

Связанные ссылки

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• Сведения о шагах последовательности задач — форматирование и секционирование диска
• Разделы жесткого диска на основе UEFI/GPT
• Разделы жесткого диска на основе BIOS/MBR