Condividi tramite

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 i cmdlet di Configuration Manager dall'unità del sito di 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 di 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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specifica il nome della raccolta associata alla distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentId

Specifica l'ID di una distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Esegue l'azione senza un messaggio di conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

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

Tipo:IResultObject
Alias:Deployment
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object