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.