Partilhar via


Remove-CMDeployment

SYNOPSIS

Remove uma implantação.

SYNTAX

SearchByValue (Padrão)

Remove-CMDeployment [-Force] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

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

PesquisaByNameMandatory

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 Gestor de Configuração.

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

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

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 Gestor de Configuração que está associada à aplicação denominada CMappD01 e que é aplicada à coleção denominada Todos os Utilizadores.

Exemplo 2: Passe um objeto de implantação e remova-o

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

Este comando obtém o objeto de implantação de aplicação especificado para a coleção denominada deiceCol01 e utiliza o operador do gasoduto para passar o objeto para Remove-CMDeployment, que remove a implantação. Uma vez que o parâmetro Force é especificado, o utilizador não é solicitado antes da colocação ser removida.

Exemplo 3: Remover uma implantação pelo seu ID

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

Este comando remove a implementação denominada aplicação01 com o ID especificado. Uma vez que o parâmetro Force é especificado, o utilizador não é solicitado antes da colocação ser removida.

PARAMETERS

-Nome de aplicação

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

Type: String
Parameter Sets: SearchByIdMandatory, SearchByNameMandatory
Aliases:

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

-Nome de coleção

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

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DeploymentId

Especifica a identificação de uma implantação.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases:

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

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

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Deployment

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Get-CMDeployment

Obter-CMDeploymentType

Remover-CMDeploymentType