Partager via

Remove-CMDeployment

  • Référence
Module:
ConfigurationManager

Supprime un déploiement.

Syntaxe

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

L’applet de commande Remove-CMDeployment supprime un déploiement d’application de Configuration Manager.

Lorsque vous supprimez un déploiement d’application, Configuration Manager ne supprime pas les instances de l’application qu’il a déjà installée. Pour supprimer ces applications, vous devez déployer l’application sur des ordinateurs avec l’action Désinstaller. Si vous supprimez un déploiement d’application ou supprimez une ressource du regroupement sur lequel vous effectuez le déploiement, l’application n’est plus visible dans le Centre logiciel.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Supprimer un déploiement d’application

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

Cette commande supprime le déploiement Configuration Manager associé à l’application nommée CMappD01 et appliqué à la collection nommée Tous les utilisateurs.

Exemple 2 : Passer un objet de déploiement et le supprimer

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

Cette commande obtient l’objet de déploiement d’application spécifié pour la collection nommée deiceCol01 et utilise l’opérateur de pipeline pour passer l’objet à Remove-CMDeployment, ce qui supprime le déploiement. Étant donné que le paramètre Force est spécifié, l’utilisateur n’est pas invité avant la suppression du déploiement.

Exemple 3 : Supprimer un déploiement par son ID

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

Cette commande supprime le déploiement nommé application01 avec l’ID spécifié. Étant donné que le paramètre Force est spécifié, l’utilisateur n’est pas invité avant la suppression du déploiement.

Paramètres

-ApplicationName

Spécifie le nom de l’application associée au déploiement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifie le nom de la collection associée au déploiement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeploymentId

Spécifie l’ID d’un déploiement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Effectue l’action sans message de confirmation.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un objet de déploiement. Pour obtenir un objet de déploiement, utilisez l’applet de commande Get-CMDeployment.

Type:IResultObject
Alias:Deployment
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object