Partager via

Remove-CMProgram

  • Référence
Module:
ConfigurationManager

Supprimer un programme d’un package.

Syntaxe

Remove-CMProgram
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMProgram
      [-Force]
      -PackageId <String>
      -ProgramName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour supprimer un programme d’un package. Lorsque vous supprimez un programme d’un package, Configuration Manager supprime tous les déploiements de ce programme. Si Configuration Manager a déjà exécuté le programme déployé sur les clients, Configuration Manager ne supprime pas le logiciel.

Remarque

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

Exemples

Exemple 1 : Supprimer un programme à l’aide d’un nom et d’un ID

Cette commande supprime le programme nommé ProgramD02 du package avec l’ID XYZ0000F.

Remove-CMProgram -PackageId "XYZ0000F" -ProgramName "ProgramD02"

Exemple 2 : Supprimer un programme à l’aide d’une variable objet

La première commande utilise l’applet de commande Get-CMProgram pour obtenir le programme nommé ProgramD02 dans le package avec l’ID XYZ0000F. Il stocke les résultats dans la variable $Prog .

La deuxième commande supprime le programme.

$Prog = Get-CMProgram -Name "ProgramD02" -PackageId "XYZ0000F"
Remove-CMProgram -InputObject $Prog -Force

Paramètres

-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

-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

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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écifiez un objet de programme à supprimer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMProgram .

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

-PackageId

Spécifiez l’ID du package avec le programme à supprimer.

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

-ProgramName

Spécifiez le nom du package avec le programme à supprimer.

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

-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