Set-CMSoftwareMeteringRule

Ändert Eigenschaften und Sicherheitsbereiche für Configuration Manager Softwaremessungsregeln.

Syntax

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

Beschreibung

Das Cmdlet Set-CMSoftwareMeteringRule ändert Eigenschaften für Softwaremessungsregeln in Configuration Manager und fügt Sicherheitsbereiche für Softwaremessungsregeln hinzu oder entfernt diese. Jede Regel muss über mindestens einen Sicherheitsbereich verfügen.

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.

Zum Ändern von Regeleigenschaften können Sie Regeln angeben, die nach ID oder Produktname geändert werden sollen, oder das Cmdlet Get-CMSoftwareMeteringRule verwenden. Ebenso können Sie den Sicherheitsbereich für Regeln für die angegebene ID, den Produktnamen oder mithilfe von Get-CMSoftwareMeteringRule ändern.

Weitere Informationen zur Softwaremessung in Configuration Manager finden Sie unter Einführung in die Softwaremessung in Configuration Manager. Weitere Informationen zu Sicherheitsbereichen finden Sie unter Planning for Security 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: Ändern des Gebietsschemas für Regeln für ein Produkt

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

Dieser Befehl legt die Gebietsschema-ID für Regeln fest, die den Produktnamen Buchhaltungspaket enthalten.

Beispiel 2: Hinzufügen eines Sicherheitsbereichs zu Regeln für ein Produkt

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

Mit diesem Befehl wird der Sicherheitsbereich Scope05 den Regeln für den Produktnamen Buchhaltungspaket hinzugefügt.

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

Gibt den Dateinamen der Software an, die eine Regel misst.

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

-Id

Gibt ein Array von IDs für Softwaremessungsregeln an.

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

-InputObject

Gibt ein Softwaremessungsregelobjekt an. Verwenden Sie das Cmdlet Get-CMSoftwareMeteringRule , um ein Softwaremessungsregelobjekt abzurufen.

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-NewProductName

Gibt einen neuen Namen für die Software an, die eine Regel misst.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Type:SwitchParameter
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:False
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 einer 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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object