Remove-CMDeployment

  • Referência
Módulo:
ConfigurationManager

Remove uma implementaçã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 implementação de aplicação do Configuration Manager.

Quando remove uma implementação de aplicação, o Configuration Manager não remove as instâncias da aplicação que já instalou. Para remover estas aplicações, tem de implementar a aplicação em computadores com a ação Desinstalar. Se eliminar uma implementação de aplicação ou remover um recurso da coleção na qual está a implementar, a aplicação deixará de estar visível no Centro de Software.

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: Remover uma implementação de aplicação

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

Este comando remove a implementação do Configuration Manager que está associada à aplicação com o nome CMappD01 e que é aplicada à coleção denominada Todos os Utilizadores.

Exemplo 2: transmitir um objeto de implementação e removê-lo

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

Este comando obtém o objeto de implementação de aplicação especificado para a coleção com o nome deiceCol01 e utiliza o operador de pipeline para transmitir o objeto para Remove-CMDeployment, que remove a implementação. Uma vez que o parâmetro Force é especificado, o utilizador não é solicitado antes de a implementação ser removida.

Exemplo 3: Remover uma implementação pelo respetivo ID

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

Este comando remove a implementação com o nome application01 com o ID especificado. Uma vez que o parâmetro Force é especificado, o utilizador não é solicitado antes de a implementação ser removida.

Parâmetros

-ApplicationName

Especifica o nome da aplicação associada à implementaçã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 à implementaçã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 o ID de uma implementação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-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

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

-InputObject

Especifica um objeto de implementação. Para obter um objeto de implementação, utilize 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