Compartilhar via


New-CMTSStepInstallApplication

Crie um passo Instalar Aplicação , que pode adicionar a uma sequência de tarefas.

Sintaxe

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 passo Instalar Aplicação . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja Acerca dos passos de sequência de tarefas: Instalar a Aplicação.

Observação

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

Exemplos

Exemplo 1

Este exemplo obtém primeiro um objeto de aplicação para a aplicação Central e guarda-o na variável $app .

A linha seguinte cria um objeto para o passo Instalar Aplicação , com a variável $app .

Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à 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 aplicação a instalar. Para obter este objeto, utilize o cmdlet Get-CMApplication .

Tipo:IResultObject[]
Aliases:Applications
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BaseVariableName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClearCache

Defina este parâmetro para $true limpar o conteúdo da aplicação da cache do cliente após a instalação da aplicação. Este comportamento é benéfico em dispositivos com pequenos discos rígidos ou ao instalar várias aplicações grandes sucessivamente.

Tipo:Boolean
Aliases:RemoveFromCache
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Condition

Especifique um objeto de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Aliases:Conditions
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContinueOnError

Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContinueOnInstallError

Adicione este parâmetro para continuar a instalar outras aplicações na lista se uma aplicação não conseguir instalar. Se não especificar esta definição e a instalação falhar, o passo termina imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para este passo de sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Disable

Adicione este parâmetro para desativar este passo de sequência de tarefas.

Tipo:SwitchParameter
Aliases:DisableThisStep
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para este passo para identificá-lo na sequência de tarefas.

Tipo:String
Aliases:StepName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RetryCount

Se uma das instalações da aplicação reiniciar inesperadamente o computador, repita este passo pelo número de vezes que especificar com este parâmetro. Por predefinição, o passo volta a tentar duas vezes. Especifique um valor inteiro de 1 para 5.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_InstallApplicationAction classe WMI de servidor.