New-CMSoftwareMeteringRule

  • Referenz
Modul:
ConfigurationManager

Erstellt eine Configuration Manager Softwaremessungsregel.

Syntax

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>]

Beschreibung

Das Cmdlet New-CMSoftwareMeteringRule erstellt eine Configuration Manager Softwaremessungsregel. Eine Softwaremessungsregel gibt eine Software zusammen mit Versionsinformationen an. Sie können die erforderlichen Dateiinformationen aus Dem Windows-Explorer abrufen.

Die Softwaremessung überwacht und sammelt Softwarenutzungsdaten von Configuration Manager Clients, z. B. wann Clients mit der Verwendung eines bestimmten Softwareprogramms begonnen haben und wie lange Benutzer mit dieser Software gearbeitet haben. Sie können Softwaremessungsregeln erstellen, die angeben, welche Software überwacht werden soll.

Weitere Informationen zur Softwaremessung in Configuration Manager finden Sie unter Einführung in die Softwaremessung in Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erstellen einer Softwaremessungsregel

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        :

Dieser Befehl erstellt eine Softwaremessungsregel für den Configuration Manager Standort mit dem Namen CM1. Der Befehl gibt den Dateinamen, die Version, den ursprünglichen Dateinamen und den Produktnamen für das Softwareprodukt an.

Parameter

-Comment

Gibt einen Kommentar für eine Softwaremessungsregel an.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-FileName

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

-FileVersion

Gibt eine Version der Software an, die eine Regel misst.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-LanguageId

Gibt eine LocaleID der Software an, die eine Regel misst. Weitere Informationen und eine Liste der Gebietsschemabezeichner finden Sie unter Anhang A: Produktverhalten.

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

-OriginalFileName

Gibt einen ursprünglichen Dateinamen der Software an, die von einer Regel ermittelt wird. Dieser Parameter kann sich vom Path-Parameter unterscheiden, wenn ein Benutzer den Namen geändert hat.

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

-Path

Gibt einen Dateipfad der Software an, die eine Regel misst.

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

-ProductName

Gibt einen Namen für ein Produkt an, das von einer Regel berechnet wird.

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

-SiteCode

Gibt einen Standortcode für eine Configuration Manager Website an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

None

Ausgaben

IResultObject