Set-CMSoftwareMeteringRule

Modul:

ConfigurationManager

Ä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 Daten zur Softwarenutzung 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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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"

Dieser Befehl fügt den Regeln für den Produktnamen Accounting Package den Sicherheitsbereich Scope05 hinzu.

Parameter

-Comment

Gibt einen Kommentar für eine Softwaremessungsregel an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

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

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisableWildcardHandling

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FileName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FileVersion

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ForceWildcardHandling

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

Gibt ein Array von IDs für Softwaremessungsregeln an.

Typ:	String
Aliase:	RuleId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

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

Typ:	IResultObject
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	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.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NewProductName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProductName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SiteCode

Gibt einen Standortcode eines Configuration Manager-Standorts an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

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

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Ähnliche Themen

• Disable-CMSoftwareMeteringRule
• Enable-CMSoftwareMeteringRule
• Get-CMSoftwareMeteringRule
• New-CMSoftwareMeteringRule
• Remove-CMSoftwareMeteringRule