New-CMTSStepInstallSoftware
Crie uma etapa Instalar Pacote, que você pode adicionar a uma sequência de tarefas.
Syntax
New-CMTSStepInstallSoftware
[-BaseVariableName <String>]
[-ContinueOnInstallError]
[-Program <IResultObject>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet cria um novo objeto de etapa Instalar Pacote. Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, consulte Sobre etapas da sequência de tarefas: Instalar o pacote.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1
Este exemplo usa primeiro o cmdlet Get-CMProgram para obter o programa Install do pacote com iD XYZ0000F.
A próxima linha cria um objeto para a etapa Instalar Pacote, usando a variável de programa.
Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 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
Parâmetros
-BaseVariableName
Use esse parâmetro para instalar pacotes de software de acordo com uma lista dinâmica de variáveis. Em seguida, a sequência de tarefas instala pacotes usando esse nome de variável base. Para obter mais informações, consulte Install software packages according to dynamic variable list.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Especifique um objeto condition a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets de condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Adicione esse parâmetro para habilitar a opção etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnInstallError
Adicione esse parâmetro para continuar instalando outros pacotes na lista se um pacote não for instalado. Se você não especificar essa configuração e a instalação falhar, a etapa será terminada imediatamente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique uma descrição opcional para esta etapa de sequência de tarefas.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Program
Especifique um objeto de programa de um pacote a ser instalado. Para obter esse objeto, use o cmdlet Get-CMProgram.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_InstallSoftwareAction classe WMI do servidor.