Compartilhar via

Remove-CMDeployment

  • Referência
Módulo:
ConfigurationManager

Remove uma implantação.

Sintaxe

Remove-CMDeployment
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeployment
      -ApplicationName <String>
      -DeploymentId <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeployment
      -ApplicationName <String>
      -CollectionName <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-CMDeployment remove uma implantação de aplicativo de Configuration Manager.

Quando você remove uma implantação de aplicativo, Configuration Manager não remove instâncias do aplicativo que ele já instalou. Para remover esses aplicativos, você deve implantar o aplicativo em computadores com a ação Desinstalar. Se você excluir uma implantação de aplicativo ou remover um recurso da coleção na qual está implantando, o aplicativo não estará mais visível no Centro de Software.

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: remover uma implantação de aplicativo

PS XYZ:\> Remove-CMDeployment -ApplicationName "CMappD01" -CollectionName "All Users"

Esse comando remove a implantação Configuration Manager associada ao aplicativo chamado CMappD01 e que é aplicada à coleção chamada Todos os Usuários.

Exemplo 2: passar um objeto de implantação e removê-lo

PS XYZ:\> Get-CMDeployment -CollectionName "deviceCol01" -FeatureType Application | Remove-CMDeployment -Force

Esse comando obtém o objeto de implantação de aplicativo especificado para a coleção chamada deiceCol01 e usa o operador de pipeline para passar o objeto para Remove-CMDeployment, que remove a implantação. Como o parâmetro Force é especificado, o usuário não é solicitado antes que a implantação seja removida.

Exemplo 3: remover uma implantação por sua ID

PS XYZ:\> Remove-CMDeployment -DeploymentId "{890082B6-7C16-4600-8807-7E0003BC9D99}" -ApplicationName "application01" -Force

Esse comando remove a implantação chamada application01 com a ID especificada. Como o parâmetro Force é especificado, o usuário não é solicitado antes que a implantação seja removida.

Parâmetros

-ApplicationName

Especifica o nome do aplicativo associado à implantação.

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

-CollectionName

Especifica o nome da coleção associada à implantação.

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

-Confirm

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

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

-DeploymentId

Especifica a ID de uma implantação.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

-Force

Executa a ação sem uma mensagem de confirmação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-InputObject

Especifica um objeto de implantação. Para obter um objeto de implantação, use o cmdlet Get-CMDeployment.

Tipo:IResultObject
Aliases:Deployment
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object