New-CMTSStepApplyOperatingSystem
Создайте шаг Apply OS Image, который можно добавить в последовательность задач.
Синтаксис
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>] Описание
В этом комлете создается новый объект шагового шага Apply OS Image. Затем используйте кодлет Add-CMTaskSequenceStep, чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в дополнительных сведениях о действиях последовательности задач: Apply OS Image.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример1
В этом примере сначала используется комлет Get-CMOperatingSystemImage для получения объекта для пакета изображений ОС. Он сохраняет этот объект в переменной $osImgPkg. На следующем шаге создается объект для шага **** Apply OS Image с использованием $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.
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigFileName
Укажите имя файла без присмотра или файла ответов Sysprep для использования для настраиваемой установки. Используйте этот параметр с параметром ConfigFilePackage.
| Type: | String |
| Aliases: | AnswerFileName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigFilePackage
Укажите объект пакета, включаемый в файл ответов без присмотра или Sysprep для использования для настраиваемой установки. Чтобы получить этот объект, используйте комлет Get-CMPackage. Используйте этот параметр с параметром ConfigFileName.
| Type: | IResultObject |
| Aliases: | AnswerFilePackage |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinueOnError
Добавьте этот параметр, чтобы включить параметр Шаг Продолжить ошибку. Когда вы включаете этот параметр, если шаг не удается, последовательность задач продолжается.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Укажите необязательное описание для этого шага последовательности задач.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Destination
Укажите расположение, в котором необходимо применить эту ОС. Если этот параметр не указан, по умолчанию NextAvailableFormattedPartition .
NextAvailableFormattedPartition: Используйте следующий последовательный раздел, который еще **** не был направлен на применение операционной системы или шаг Apply Data Image в этой последовательности задач.SpecificDiskAndPartition: Укажите номер диска с параметром DestinationDisk и номер раздела с параметром DestinationPartition.SpecificLogicalDriverLetter. Используйте параметр DestinationDriveLetter, чтобы указать логическое письмо диска, назначенное разделу Windows PE. Эта буква диска может быть отличается от буквы диска, назначенной недавно развернутой ОС.LogicalDriverLetterInVariable. Используйте параметр DestinationVariable для указания переменной последовательности задач, содержащей букву диска, назначенную разделу Windows PE. Эта переменная обычно задана с параметром DiskNumberVariable для шага последовательности задач Set-CMTSStepPartitionDisk или **** New-CMTSStepPartitionDisk.
| Type: | DestinationType |
| Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationDisk
При использовании -Destination SpecificDiskAndPartition используйте этот параметр, чтобы указать номер диска. Укажите несколько часов от 0 до 99 . Также используйте параметр DestinationPartition.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationDriveLetter
При использовании -Destination SpecificLogicalDriverLetter используйте этот параметр, чтобы указать логическое письмо диска. Укажите букву C диска от до Z .
| Type: | String |
| Aliases: | DestinationLogicalDrive |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationPartition
При использовании -Destination SpecificDiskAndPartition используйте этот параметр, чтобы указать номер раздела. Укажите несколько часов от 1 до 99 . Также используйте параметр DestinationDisk.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationVariable
При использовании используйте этот параметр, чтобы указать переменную последовательности задач -Destination LogicalDriverLetterInVariable с помощью буквы логического диска. Переменное имя должно быть альфа-числом без пробелов и менее 256 символов.
| Type: | String |
| Aliases: | DestinationVariableName |
| 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 |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ImagePackage
Укажите объект пакета изображений ОС. Этот шаг применяет ОС с этого изображения. Для набора индекса изображений используйте параметр ImagePackageIndex.
Чтобы получить этот объект, используйте комлет Get-CMOperatingSystemImage.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ImagePackageIndex
Укажите значение integer индекса изображений. Используйте этот параметр с параметром ImagePackage.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstallPackage
Укажите объект пакета обновления ОС. Этот шаг применяет ОС из исходного источника установки. Для установки выпуска используйте параметр InstallPackageIndex.
Чтобы получить этот объект, используйте кодлет Get-CMOperatingSystemInstaller.
| Type: | IResultObject |
| Aliases: | UpgradePackage |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstallPackageIndex
Укажите многофайлевое значение выпуска пакета обновления ОС. Используйте этот параметр с параметром InstallPackage.
| Type: | Int32 |
| Aliases: | UpgradePackageIndex |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LayeredDriver
Начиная с версии 2107, используйте этот параметр для выбора других типов клавиатур, общих с японским и корейским языками. Укажите значение integer для многоуровневой установки драйвера с помощью Windows. Используйте те же значения, что и переменная последовательности задач OsdLayeredDriver.
| Type: | OsdLayeredDriver |
| Aliases: | KeyboardDriver |
| Accepted values: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Укажите имя для этого шага, чтобы идентифицировать его в последовательности задач.
| Type: | String |
| Aliases: | StepName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunFromNet
Установите этот параметр, чтобы разрешить последовательности задач применять изображение $true ОС непосредственно из точки распространения.
Для обеспечения наибольшей безопасности рекомендуется не включить этот параметр. Этот параметр предназначен для использования на устройствах с ограниченной емкостью хранения. Дополнительные сведения см. в материалах Access content непосредственно из точки распространения.
| Type: | Boolean |
| Aliases: | AllowAccessFromDistributionPoint |
| 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 |
-Отключение
Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.
| Type: | SwitchParameter |
| Aliases: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Нет
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом объекте возврата и его свойствах см. в SMS_TaskSequence_ApplyOperatingSystemAction класса WMI сервера.