New-CMTSPartitionSetting
Создайте объект секционирования диска, который будет использоваться на шаге последовательности задач Форматирование и секционирование диска .
Синтаксис
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 сервера.