Export (0) Print
Expand All
Expand Minimize

Set-CMSoftwareMeteringSetting

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

Set-CMSoftwareMeteringSetting

Configures Configuration Manager software metering properties.

Syntax

Parameter Set: SetByName
Set-CMSoftwareMeteringSetting [-AutoCreateDisabledRule <Boolean> ] [-AutoCreatePercentage <Int32> ] [-AutoCreateThreshold <Int32> ] [-DataRetentionDayCount <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Set-CMSoftwareMeteringSetting cmdlet configures software metering properties for Microsoft System Center 2012 Configuration Manager.

Software metering can use software inventory information to create software metering rules. When you select this feature, System Center 2012 Configuration Manager identifies multiple computers that use the same software and creates a rule to track that usage in the future. You decide how long to keep software metering data that System Center 2012 Configuration Manager uses to create rules.

To prevent System Center 2012 Configuration Manager from creating too many rules, you can specify what percentage of computers use a piece of software before System Center 2012 Configuration Manager creates a rule. You can also set a rule threshold. If the number of software metering rules exceeds this threshold, System Center 2012 Configuration Manager stops automatically creating rules.

When System Center 2012 Configuration Manager creates a rule automatically, it creates that rule as disabled. A disabled rule does not collect information from clients. You can use the Enable-CMSoftwareMeteringRule cmdlet to enable a rule. You can use the Remove-CMSoftwareMeteringRule cmldet to remove unwanted rules.

Parameters

-AutoCreateDisabledRule<Boolean>

Specifies whether Configuration Manager automatically creates software metering rules. If this value is $True, Configuration Manager automatically creates software metering rules. If this value is $False, it does not automatically create rules.

When Configuration Manager creates rules, it creates them as disabled.

You can use the values set by other parameters of this cmdlet to limit creation of rules.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AutoCreatePercentage<Int32>

Specifies a percentage of computers that use a piece of software for Configuration Manager to create a rule. Software metering calculates the number of computers as all the computers monitored for software metering by Configuration Manager, not just for a single site. Valid values are integers from 1 through 99


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AutoCreateThreshold<Int32>

Specifies a number of software metering rules as a threshold. When Configuration Manager exceeds this threshold, it stops automatically creating rules. The number of rules counted for this threshold includes all software metering rules, not only those that Configuration Manager creates automatically. Valid values are integers from 1 through 1000.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DataRetentionDayCount<Int32>

Specifies a number of days that Configuration Manager keeps software metering data.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Disable automatic rule creation

This command disables automatic rule creation. System Center 2012 Configuration Manager does not automatically create software metering rules after you run this command.


PS C:\> Set-CMSoftwareMeteringSetting -AutoCreateDisabledRule $False

Example 2: Configure automatic rule creation

This command enables automatic rule creation and sets properties for it. This command sets the percentage of computers that use a piece of software to 50 percent, the rule threshold to 200, and the amount of time System Center 2012 Configuration Manager keeps software metering data to 30 days.


PS C:\> Set-CMSoftwareMeteringSetting -AutoCreateDisabledRule $True -AutoCreatePercentage 50 -AutoCreateThreshold 200 -DataRetentionDayCount 30

Example 3: Change automatic rule creation percentage

This command changes the percentage of computers that use a piece of software to 20 percent.


PS C:\> Set-CMSoftwareMeteringSetting -AutoCreatePercentage 20

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft