New-CMTSStepInstallSoftware

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

Синтаксис

New-CMTSStepInstallSoftware
   [-BaseVariableName <String>]
   [-ContinueOnInstallError]
   [-Program <IResultObject>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание

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

Примеры

Пример1

В этом примере сначала используется комлет Get-CMProgram для получения программы Install из пакета с ID XYZ0000F.

Следующая строка создает объект для шага Install Package с помощью переменной программы.

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

$program = Get-CMProgram -PackageId "XYZ0000F" -ProgramName "Install"

$step = New-CMTSStepInstallSoftware -Name "Install Package" -Program $program

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

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

Параметры

-BaseVariableName

Используйте этот параметр для установки пакетов программного обеспечения в соответствии с динамическим списком переменной. Затем последовательность задач устанавливает пакеты с помощью этого базового имени переменной. Дополнительные сведения см. в сообщении Install software packages according to dynamic variable list.

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

-Condition

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

Type:IResultObject[]
Aliases:Conditions
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

-ContinueOnInstallError

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

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

-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

-Name

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

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

-Program

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

Type:IResultObject
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_InstallSoftwareAction класса WMI сервера.