New-CMTSStepInstallUpdate

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

Синтаксис

New-CMTSStepInstallUpdate
   [-RetryCount <Int32>]
   [-Target <TargetType>]
   [-UseCache <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

Пример 1

В этом примере создается объект для шага Установка программного обеспечения Обновления для установки всех доступных обновлений из кэшированных результатов проверки. Повторная попытка будет выполняться до пяти раз.

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

$step = New-CMTSStepInstallUpdate -Name "Install Software Updates" -Target All -UseCache $true -RetryCount 5

$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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Disable

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

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetryCount

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Target

Укажите значение типа устанавливаемых обновлений:

  • All: установите все доступные обновления программного обеспечения. Сначала разверните эти обновления в коллекции, членом которой является компьютер.

  • Mandatory: установите все обязательные обновления программного обеспечения с установленными администратором крайними сроками установки.

Type:TargetType
Aliases:InstallUpdateBasedOnTypeOfDeployment
Accepted values:All, Mandatory
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseCache

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

Type:Boolean
Aliases:EnableEvaluateFromCache
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

IResultObject

Примечания

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