Поделиться через

New-CMTSStepApplyOperatingSystem

  • Ссылка
Модуль:
ConfigurationManager

Создайте шаг Применить образ ОС , который можно добавить в последовательность задач.

Синтаксис

New-CMTSStepApplyOperatingSystem
   [-ConfigFileName <String>]
   [-ConfigFilePackage <IResultObject>]
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-LayeredDriver <OsdLayeredDriver>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   [-ImagePackage <IResultObject>]
   [-ImagePackageIndex <Int32>]
   [-InstallPackage <IResultObject>]
   [-InstallPackageIndex <Int32>]
   [-RunFromNet <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Этот командлет создает новый объект шага Применить образ ОС . Затем используйте командлет Add-CMTaskSequenceStep , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: применение образа ОС.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1

В этом примере сначала используется командлет Get-CMOperatingSystemImage для получения объекта для пакета образа ОС. Этот объект сохраняется в переменной $osImgPkg . На следующем шаге создается объект для шага Применить образ ОС , используя объект $osImgPkg в качестве пакета образа.

Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 11.

$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Параметры

-Condition

Укажите объект условия для использования на этом шаге. Чтобы получить этот объект, используйте один из командлетов условия последовательности задач. Например, Get-CMTSStepConditionVariable.

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

-ConfigFileName

Укажите имя файла автоматической установки или файла ответов Sysprep, который будет использоваться для пользовательской установки. Используйте этот параметр с параметром ConfigFilePackage .

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

-ConfigFilePackage

Укажите объект пакета, включающий автоматический файл ответов или файл ответов Sysprep, который будет использоваться для пользовательской установки. Чтобы получить этот объект, используйте командлет Get-CMPackage . Используйте этот параметр с параметром ConfigFileName .

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

-Confirm

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

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

-ContinueOnError

Добавьте этот параметр, чтобы включить параметр шага Продолжить при ошибке. Если этот параметр включен, если шаг завершается ошибкой, последовательность задач продолжается.

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

-Description

Укажите необязательное описание для этого шага последовательности задач.

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

-Destination

Укажите расположение, в котором требуется применить эту ОС. Если этот параметр не указан, по умолчанию используется значение NextAvailableFormattedPartition.

  • NextAvailableFormattedPartition: используйте следующий последовательный раздел, не предназначенный для шага Применить операционную систему или Применить образ данных в этой последовательности задач.

  • SpecificDiskAndPartition: укажите номер диска с параметром DestinationDisk и номер раздела с параметром DestinationPartition .

  • SpecificLogicalDriverLetter: используйте параметр DestinationDriveLetter , чтобы указать логическую букву диска, назначенную секции windows PE. Эта буква диска может отличаться от буквы диска, назначенной только что развернутой ОС.

  • LogicalDriverLetterInVariable: используйте параметр DestinationVariable , чтобы указать переменную последовательности задач, содержащую букву диска, назначенную секции Windows PE. Эта переменная обычно задается с помощью параметра DiskNumberVariable командлетов Set-CMTSStepPartitionDisk или New-CMTSStepPartitionDisk для шага последовательности задач Формат и секционирование диска .

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

-DestinationDisk

При использовании -Destination SpecificDiskAndPartitionиспользуйте этот параметр, чтобы указать номер диска. Укажите целое число от 0 до 99. Также используйте параметр DestinationPartition .

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

-DestinationDriveLetter

При использовании -Destination SpecificLogicalDriverLetterиспользуйте этот параметр, чтобы указать логическую букву диска. Укажите букву диска от C до Z.

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

-DestinationPartition

При использовании -Destination SpecificDiskAndPartitionиспользуйте этот параметр, чтобы указать номер секции. Укажите целое число от 1 до 99. Также используйте параметр DestinationDisk .

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

-DestinationVariable

При использовании -Destination LogicalDriverLetterInVariableиспользуйте этот параметр, чтобы указать переменную последовательности задач с буквой логического диска. Имя переменной должно быть буквенно-цифровым без пробелов и менее 256 символов.

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

-Disable

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-ImagePackage

Укажите объект пакета образа ОС. На этом шаге применяется ОС из этого образа. Используйте параметр ImagePackageIndex , чтобы задать индекс изображения.

Чтобы получить этот объект, используйте командлет Get-CMOperatingSystemImage .

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

-ImagePackageIndex

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

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

-InstallPackage

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

Чтобы получить этот объект, используйте командлет Get-CMOperatingSystemInstaller .

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

-InstallPackageIndex

Укажите целочисленное значение выпуска пакета обновления ОС. Используйте этот параметр вместе с параметром InstallPackage .

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

-LayeredDriver

Начиная с версии 2107, используйте этот параметр для выбора других типов клавиатур, которые являются общими для японского и корейского языков. Укажите целочисленное значение для многоуровневого драйвера для установки с Windows. Используйте те же значения, что и переменная последовательности задач OsdLayeredDriver .

Тип:OsdLayeredDriver
Aliases:KeyboardDriver
Допустимые значения:DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

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

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

-RunFromNet

Задайте для этого параметра значение , $true чтобы последовательность задач применяла образ ОС непосредственно из точки распространения.

Для обеспечения максимальной безопасности рекомендуется не включать этот параметр. Этот параметр предназначен для использования на устройствах с ограниченной емкостью хранилища. Дополнительные сведения см. в разделе Доступ к содержимому непосредственно из точки распространения.

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

-WhatIf

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

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

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

None

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

IResultObject

Примечания

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