Set-CMSoftwareMeteringSetting
Konfiguriert Configuration Manager-Softwaremessungseigenschaften.
Syntax
Set-CMSoftwareMeteringSetting
[-AutoCreateDisabledRule <Boolean>]
[-AutoCreatePercentage <Int32>]
[-AutoCreateThreshold <Int32>]
[-DataRetentionDayCount <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-CMSoftwareMeteringSetting konfiguriert Softwaremessungseigenschaften für Configuration Manager.
Die Softwaremessung kann Softwareinventurinformationen verwenden, um Softwaremessungsregeln zu erstellen. Wenn Sie dieses Feature auswählen, identifiziert Configuration Manager mehrere Computer, die dieselbe Software verwenden, und erstellt eine Regel zum Nachverfolgen dieser Verwendung. Sie entscheiden, wie lange Softwaremessungsdaten beibehalten werden sollen, die Configuration Manager zum Erstellen von Regeln verwendet.
Um zu verhindern, dass Configuration Manager zu viele Regeln erstellt, können Sie angeben, welcher Prozentsatz der Computer eine Software verwendet, bevor Configuration Manager eine Regel erstellt.
Sie können auch einen Regelschwellenwert festlegen. Wenn die Anzahl der Softwaremessungsregeln diesen Schwellenwert überschreitet, beendet Configuration Manager das automatische Erstellen von Regeln.
Wenn Configuration Manager eine Regel automatisch erstellt, wird diese Regel als deaktiviert erstellt. Eine deaktivierte Regel sammelt keine Informationen von Clients. Sie können das Cmdlet Enable-CMSoftwareMeteringRule verwenden, um eine Regel zu aktivieren. Sie können das Cmdlet Remove-CMSoftwareMeteringRule verwenden, um unerwünschte Regeln zu entfernen.
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: Deaktivieren der automatischen Regelerstellung
PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreateDisabledRule $FalseDieser Befehl deaktiviert die automatische Regelerstellung. Configuration Manager erstellt nicht automatisch Softwaremessungsregeln, nachdem Sie diesen Befehl ausgeführt haben.
Beispiel 2: Konfigurieren der automatischen Regelerstellung
PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreateDisabledRule $True -AutoCreatePercentage 50 -AutoCreateThreshold 200 -DataRetentionDayCount 30Dieser Befehl aktiviert die automatische Regelerstellung und legt Eigenschaften dafür fest. Dieser Befehl legt den Prozentsatz der Computer, die eine Software verwenden, auf 50 Prozent, den Regelschwellenwert auf 200 fest, und die Zeitspanne, für die Configuration Manager Softwaremessungsdaten auf 30 Tage hält.
Beispiel 3: Ändern des Prozentsatzes der automatischen Regelerstellung
PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreatePercentage 20Dieser Befehl ändert den Prozentsatz der Computer, die eine Software verwenden, in 20 Prozent.
Parameter
-AutoCreateDisabledRule
Gibt an, ob Configuration Manager automatisch Softwaremessungsregeln erstellt. Wenn dieser Wert $True ist, erstellt Configuration Manager automatisch Softwaremessungsregeln. Wenn dieser Wert $False ist, werden nicht automatisch Regeln erstellt.
Wenn Von Configuration Manager Regeln erstellt werden, werden diese als deaktiviert erstellt.
Sie können die Werte verwenden, die von anderen Parametern dieses Cmdlets festgelegt werden, um die Erstellung von Regeln einzuschränken.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AutoCreatePercentage
Gibt einen Prozentsatz der Computer an, die eine Software für Configuration Manager verwenden, um eine Regel zu erstellen. Die Softwaremessung berechnet die Anzahl der Computer als alle Computer, die von Configuration Manager auf Softwaremessung überwacht werden, nicht nur für einen einzelnen Standort. Gültige Werte sind ganze Zahlen von 1 bis 99.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AutoCreateThreshold
Gibt eine Reihe von Softwaremessungsregeln als Schwellenwert an. Wenn Configuration Manager diesen Schwellenwert überschreitet, wird das automatische Erstellen von Regeln beendet. Die Anzahl der Regeln, die für diesen Schwellenwert gezählt werden, umfasst alle Softwaremessungsregeln, nicht nur die Regeln, die Von Configuration Manager automatisch erstellt werden. Gültige Werte sind ganze Zahlen zwischen 1 und 1000.
| Typ: | Int32 |
| 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 |
-DataRetentionDayCount
Gibt die Anzahl der Tage an, in denen Configuration Manager Softwaremessungsdaten speichert.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| 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 |
-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 |
-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
None
Ausgaben
System.Object