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


New-CMTSStepUpgradeOperatingSystem

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

Синтаксис

New-CMTSStepUpgradeOperatingSystem
   [-DriverPackage <IResultObject>]
   [-DynamicUpdateSetting <DynamicUpdateOption>]
   [-EditionIndex <Int32>]
   [-IgnoreMessage <Boolean>]
   [-ProductKey <String>]
   [-ScanOnly <Boolean>]
   [-SetupTimeout <Int32>]
   [-SourcePath <String>]
   [-StagedContent <String>]
   [-UpgradePackage <IResultObject>]
   [-SoftwareUpdate <IResultObject[]>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

Пример 1

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

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

$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1

$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast

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

Параметры

-Condition

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

Тип:IResultObject[]
Aliases:Conditions
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

-Disable

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

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

-DisableWildcardHandling

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

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

-DriverPackage

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

Используйте параметр StagedContent , чтобы указать расположение содержимого драйвера.

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

-DynamicUpdateSetting

Используйте этот параметр для динамического обновления программы установки Windows с помощью Центра обновления Windows.

  • DisablePolicy: не используйте динамическое обновление.
  • UsingPolicy: включите программу установки для использования динамического обновления, например для поиска, скачивания и установки обновлений.
  • OverridePolicy: временно переопределите локальную политику в режиме реального времени для выполнения операций динамического обновления. Компьютер получает обновления из Центра обновления Windows.
Тип:DynamicUpdateOption
Допустимые значения:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EditionIndex

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

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

-ForceWildcardHandling

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

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

-IgnoreMessage

Присвойте этому параметру значение , $true чтобы указать, что программа установки Windows завершит установку, игнорируя любые сообщения о совместимости, которые могут быть отклонены.

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

-Name

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

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

-ProductKey

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

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

-ScanOnly

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

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

-SetupTimeout

Укажите количество минут до того, как Configuration Manager не выполнит этот шаг. Этот параметр удобен, если программа установки Windows останавливает обработку, но не завершает работу.

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

-SoftwareUpdate

Начиная с версии 2107, укажите объект обновления программного обеспечения для обновления клиентской ОС Windows с помощью обновления компонентов. Чтобы получить этот объект, используйте командлет Get-CMSoftwareUpdate .

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

-SourcePath

Укажите локальный или сетевой путь к носителю Windows, который использует программа установки Windows.

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

-StagedContent

Используйте этот параметр с DriverPackage , чтобы указать расположение для содержимого драйвера. Можно указать локальную папку, сетевой путь или переменную последовательности задач.

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

-UpgradePackage

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

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

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

-WhatIf

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

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

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

None

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

IResultObject

Примечания

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