Set-CMSoftwareMeteringSetting

配置 Configuration Manager 软件计量属性。

语法

Set-CMSoftwareMeteringSetting
   [-AutoCreateDisabledRule <Boolean>]
   [-AutoCreatePercentage <Int32>]
   [-AutoCreateThreshold <Int32>]
   [-DataRetentionDayCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMSoftwareMeteringSetting cmdlet 配置 Configuration Manager 的软件计量属性。

软件计量可以使用软件清单信息来创建软件计量规则。 选择此功能时,Configuration Manager 将标识使用同一软件的多台计算机,并创建一个规则来跟踪该使用情况。 你可以决定将 Configuration Manager 用于创建规则的软件计量数据保留多久。

若要防止 Configuration Manager 创建过多规则,可以在 Configuration Manager 创建规则之前指定使用软件的计算机所占的百分比。

您还可以设置规则阈值。 如果软件计量规则的数量超过此阈值,Configuration Manager 将自动停止创建规则。

当 Configuration Manager 自动创建规则时,它会创建禁用的规则。 禁用的规则不会从客户端收集信息。 可以使用 Enable-CMSoftwareMeteringRule cmdlet 启用规则。 您可以使用 Remove-CMSoftwareMeteringRule cmdlet 删除不需要的规则。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\> 。 有关详细信息,请参阅 入门

示例

示例 1:禁用自动规则创建

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

此命令禁用自动规则创建。 运行此命令后,Configuration Manager 不会自动创建软件计量规则。

示例 2:配置自动规则创建

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

此命令启用自动规则创建并设置其属性。 此命令将使用软件的计算机百分比设定为 50%,规则阈值为 200,Configuration Manager 将软件计量数据保留的时间量设定为 30 天。

示例 3:更改自动规则创建百分比

PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreatePercentage 20

此命令将使用一部分软件的计算机的百分比更改为 20%。

参数

-AutoCreateDisabledRule

指定 Configuration Manager 是否自动创建软件计量规则。 如果此值为 $True,Configuration Manager 将自动创建软件计量规则。 如果此值是$False,则不会自动创建规则。

当 Configuration Manager 创建规则时,它会将其创建为已禁用。

您可以使用此 cmdlet 的其他参数设置的值来限制规则的创建。

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

-AutoCreatePercentage

指定使用配置管理器软件创建规则的计算机的百分比。 软件计量计算计算机数,因为所有计算机都由 Configuration Manager 监视进行软件计量,而不仅是单个站点。 有效值为从 1 到 99 的整数。

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

-AutoCreateThreshold

将大量软件计量规则指定为阈值。 当 Configuration Manager 超过此阈值时,将自动停止创建规则。 计入此阈值的规则数包括所有软件计量规则,而不仅是 Configuration Manager 自动创建的规则。 有效值为从 1 到 1000 的整数。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DataRetentionDayCount

指定 Configuration Manager 保留软件计量数据的天数。

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

-DisableWildcardHandling

此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用

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

-ForceWildcardHandling

此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

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

输入

输出

System.Object