Remove-CMDeployment

  • Riferimento
Modulo:
ConfigurationManager

Rimuove una distribuzione.

Sintassi

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>]

Descrizione

Il cmdlet Remove-CMDeployment rimuove una distribuzione dell'applicazione da Configuration Manager.

Quando si rimuove una distribuzione dell'applicazione, Configuration Manager non rimuove le istanze dell'applicazione già installata. Per rimuovere queste applicazioni, è necessario distribuire l'applicazione nei computer con l'azione Disinstalla. Se si elimina una distribuzione dell'applicazione o si rimuove una risorsa dalla raccolta in cui si esegue la distribuzione, l'applicazione non sarà più visibile in Software Center.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere una distribuzione dell'applicazione

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

Questo comando rimuove la distribuzione Configuration Manager associata all'applicazione denominata CMappD01 e applicata alla raccolta denominata All Users.

Esempio 2: Passare un oggetto di distribuzione e rimuoverlo

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

Questo comando ottiene l'oggetto di distribuzione dell'applicazione specificato per la raccolta denominata deiceCol01 e usa l'operatore della pipeline per passare l'oggetto a Remove-CMDeployment, rimuovendo la distribuzione. Poiché viene specificato il parametro Force , all'utente non viene richiesto prima della rimozione della distribuzione.

Esempio 3: Rimuovere una distribuzione in base al relativo ID

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

Questo comando rimuove la distribuzione denominata application01 con l'ID specificato. Poiché viene specificato il parametro Force , all'utente non viene richiesto prima della rimozione della distribuzione.

Parametri

-ApplicationName

Specifica il nome dell'applicazione associata alla distribuzione.

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

-CollectionName

Specifica il nome della raccolta associata alla distribuzione.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentId

Specifica l'ID di una distribuzione.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-Force

Esegue l'azione senza un messaggio di conferma.

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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-InputObject

Specifica un oggetto di distribuzione. Per ottenere un oggetto di distribuzione, usare il cmdlet Get-CMDeployment.

Type:IResultObject
Aliases:Deployment
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object