New-CMSoftwareMeteringRule
Crée une règle de contrôle de logiciel Configuration Manager.
Syntaxe
New-CMSoftwareMeteringRule
[-Comment <String>]
[-FileName <String>]
[-FileVersion <String>]
[-LanguageId <Int32>]
[-OriginalFileName <String>]
-ProductName <String>
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareMeteringRule
-Path <String>
[-ProductName <String>]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-CMSoftwareMeteringRule crée une règle de contrôle de logiciel Configuration Manager. Une règle de contrôle de logiciel spécifie un logiciel, ainsi que des informations de version. Vous pouvez obtenir les informations de fichier nécessaires à partir de l’Explorateur Windows.
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 plus d’informations sur le contrôle des logiciels dans Configuration Manager, consultez Présentation du contrôle de logiciel 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 : Créer une règle de contrôle de logiciel
PS XYZ:\> New-CMSoftwareMeteringRule -Path "Notepad.exe" -SiteCode "CM1" -FileVersion "6.1.7600.16385" -OriginalFileName "NOTEPAD.EXE" -ProductName "Microsoft Windows Operating System"
ApplyToChildSites : True
Comment :
Enabled : True
FileName : Notepad.exe
FileVersion : 6.1.7600.16385
LanguageID :
LastUpdateTime :
OriginalFileName : NOTEPAD.EXE
ProductName : Microsoft Windows Operating System
RuleID :
SecurityKey :
SiteCode : CM1
SourceSite :Cette commande crée une règle de contrôle de logiciel pour le site Configuration Manager nommée CM1. La commande spécifie le nom de fichier, la version, le nom de fichier d’origine et le nom du produit logiciel.
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
| 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 |
-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 |
-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 Path 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 |
-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: | True |
| 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 pour 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
None
Sorties
IResultObject