New-CMTSStepInstallApplication

  • Referência
Módulo:
ConfigurationManager

Crie uma etapa Instalar Aplicativo , que você pode adicionar a uma sequência de tarefas.

Syntax

New-CMTSStepInstallApplication
   [-Application <IResultObject[]>]
   [-BaseVariableName <String>]
   [-ClearCache <Boolean>]
   [-ContinueOnInstallError]
   [-RetryCount <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria um novo objeto de etapa Instalar Aplicativo . 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, confira Sobre as etapas da sequência de tarefas: Instalar Aplicativo.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1

Este exemplo primeiro obtém um objeto de aplicativo para o aplicativo Central e o salva na variável $app .

A próxima linha cria um objeto para a etapa Instalar Aplicativo , usando a variável $app .

Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 11.

$app = Get-CMApplication -Name "Central app"

$step = New-CMTSStepInstallApplication -Name "Install Application" -Application $app

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

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

Parâmetros

-Application

Especifique um ou mais objetos de aplicativo a serem instalados. Para obter esse objeto, use o cmdlet Get-CMApplication .

Type:IResultObject[]
Aliases:Applications
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BaseVariableName

Use esse parâmetro para instalar aplicativos de acordo com uma lista de variáveis dinâmicas. Em seguida, a sequência de tarefas instala aplicativos usando esse nome de variável base. Para obter mais informações, consulte Instalar aplicativos de acordo com a lista de variáveis dinâmicas.

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

-ClearCache

Defina esse parâmetro para $true limpar o conteúdo do aplicativo do cache do cliente depois de instalar o aplicativo. Esse comportamento é benéfico em dispositivos com discos rígidos pequenos ou ao instalar muitos aplicativos grandes em sucessão.

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

-Condition

Especifique um objeto de condição a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Adicione esse parâmetro para habilitar a opção de 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnInstallError

Adicione esse parâmetro para continuar instalando outros aplicativos na lista se um aplicativo não instalar. Se você não especificar essa configuração e a instalação falhar, a etapa terminará imediatamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetryCount

Se uma das instalações do aplicativo reiniciar inesperadamente o computador, tente novamente essa etapa pelo número de vezes que você especificar com esse parâmetro. Por padrão, a etapa tenta novamente duas vezes. Especifique um valor inteiro de 1 para 5.

Type:Int32
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_InstallApplicationAction classe WMI do servidor.