Partager via

Set-CMSoftwareMeteringRule

  • Référence
Module:
ConfigurationManager

Modifie les propriétés et les étendues de sécurité pour les règles de contrôle des logiciels Configuration Manager.

Syntaxe

Set-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   -InputObject <IResultObject>
   [-LanguageId <Int32>]
   [-NewProductName <String>]
   [-OriginalFileName <String>]
   [-PassThru]
   [-Path <String>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   [-LanguageId <Int32>]
   [-NewProductName <String>]
   [-OriginalFileName <String>]
   [-PassThru]
   [-Path <String>]
   -ProductName <String>
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   -Id <String>
   [-LanguageId <Int32>]
   [-NewProductName <String>]
   [-OriginalFileName <String>]
   [-PassThru]
   [-Path <String>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-CMSoftwareMeteringRule modifie les propriétés des règles de contrôle de logiciel dans Configuration Manager et ajoute ou supprime des étendues de sécurité pour les règles de contrôle des logiciels. Chaque règle doit avoir au moins une étendue de sécurité.

Le contrôle logiciel surveille et collecte les données d’utilisation des logiciels à partir des clients Configuration Manager, par exemple quand les clients ont commencé à utiliser un programme logiciel particulier et la durée pendant laquelle les utilisateurs ont travaillé avec ce logiciel. Vous pouvez créer des règles de contrôle de logiciel qui spécifient les logiciels à surveiller.

Pour modifier les propriétés de règle, vous pouvez spécifier des règles à modifier par ID ou par nom de produit, ou utiliser l’applet de commande Get-CMSoftwareMeteringRule . De même, vous pouvez modifier l’étendue de sécurité des règles pour l’ID spécifié, le nom de produit ou à l’aide de Get-CMSoftwareMeteringRule.

Pour plus d’informations sur le contrôle des logiciels dans Configuration Manager, consultez Présentation du contrôle de logiciel dans Configuration Manager. Pour plus d’informations sur les étendues de sécurité, consultez Planification de la sécurité dans Configuration Manager.

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 : Modifier les paramètres régionaux pour les règles d’un produit

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -LanguageID 1036

Cette commande définit l’ID des paramètres régionaux pour les règles qui incluent le nom de produit Package comptable.

Exemple 2 : Ajouter une étendue de sécurité aux règles d’un produit

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -SecurityScopeAction AddMembership -SecurityScopeName "Scope05"

Cette commande ajoute l’étendue de sécurité appelée Scope05 aux règles pour le nom de produit Accounting Package.

Paramètres

-Comment

Spécifie un commentaire pour une règle de contrôle de logiciel.

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

-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

-FileName

Spécifie le nom de fichier du logiciel qu’une règle mesure.

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

-FileVersion

Spécifie une version du logiciel qu’une règle mesure.

Type:String
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

-Id

Spécifie un tableau d’ID pour les règles de contrôle des logiciels.

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

-InputObject

Spécifie un objet de règle de contrôle de logiciel. Pour obtenir un objet de règle de contrôle de logiciel, utilisez l’applet de commande Get-CMSoftwareMeteringRule .

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

-LanguageId

Spécifie un LocaleID du logiciel qu’une règle mesure. Pour plus d’informations et pour obtenir la liste des identificateurs de paramètres régionaux, consultez Annexe A : Comportement du produit.

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

-NewProductName

Spécifie un nouveau nom pour le logiciel qu’une règle mesure.

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

-OriginalFileName

Spécifie un nom de fichier d’origine du logiciel qu’une règle mesure. Ce paramètre peut différer du paramètre FileName si un utilisateur a modifié le nom.

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

-PassThru

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

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

-Path

Spécifie un chemin d’accès au fichier du logiciel qu’une règle mesure.

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

-ProductName

Spécifie un nom pour un produit qu’une règle mesure.

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

-SiteCode

Spécifie un code de site d’un site Configuration Manager.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
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