Partager via

Disable-CMProgram

  • Référence
Module:
ConfigurationManager

Désactivez un programme dans un package.

Syntax

Disable-CMProgram
       -InputObject <IResultObject>
       [-PassThru]
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageId <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageName <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Utilisez cette cmdlet pour désactiver un programme dans un package.

Désactivez un programme pour empêcher les clients Configuration Manager de l’exécutent. Lorsque vous désactivez un programme, Configuration Manager distribue toujours le contenu du package aux points de distribution et envoie le déploiement du programme aux clients. Le client n’affiche pas ou n’exécute pas le programme sur le client. Ce comportement est le même lorsque vous désactivez le déploiement du programme.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : désactiver un programme

Cette commande désactive le programme nommé ProgramD02 dans le package qui a l’ID XYZ00007.

Disable-CMProgram -PackageId "XYZ00007" -ProgramName "ProgramD02"

Paramètres

- Confirmer

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

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

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

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

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifiez un objet programme à désactiver. Pour obtenir cet objet, utilisez l’cmdlet Get-CMProgram.

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

-PackageId

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

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

-PackageName

Spécifiez le nom du package avec le programme à désactiver.

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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette cmdlet peut ne pas générer de sortie.

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

-ProgramName

Spécifiez le nom du package avec le programme à désactiver.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_Program classe WMI du serveur.