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 сервера.