Share via

Set-CMSoftwareMeteringSetting

  • Referência
Módulo:
ConfigurationManager

Configura as propriedades de medição de software do Configuration Manager.

Syntax

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

Description

O cmdlet Set-CMSoftwareMeteringSetting configura propriedades de medição de software para o Configuration Manager.

A medição de software pode usar informações de inventário de software para criar regras de medição de software. Quando você seleciona esse recurso, o Configuration Manager identifica vários computadores que usam o mesmo software e cria uma regra para rastrear esse uso. Você decide por quanto tempo manter dados de medição de software que o Configuration Manager usa para criar regras.

Para impedir que o Configuration Manager crie muitas regras, você pode especificar qual porcentagem de computadores usa um software antes que o Configuration Manager crie uma regra.

Você também pode definir um limite de regra. Se o número de regras de medição de software exceder esse limite, o Configuration Manager para de criar regras automaticamente.

Quando o Configuration Manager cria uma regra automaticamente, ela cria essa regra como desabilitada. Uma regra desabilitada não coleta informações de clientes. Você pode usar o cmdlet Enable-CMSoftwareMeteringRule para habilitar uma regra. Você pode usar o cmdlet Remove-CMSoftwareMeteringRule para remover regras indesejadas.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Desabilitar a criação automática de regras

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

Este comando desabilita a criação automática de regras. O Configuration Manager não cria automaticamente regras de medição de software após executar este comando.

Exemplo 2: Configurar a criação automática de regras

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

Esse comando habilita a criação automática de regras e define propriedades para ela. Este comando define a porcentagem de computadores que usam um software como 50%, o limite de regra como 200, e o tempo que o Configuration Manager mantém o software que medem dados para 30 dias.

Exemplo 3: Alterar a porcentagem de criação automática de regras

PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreatePercentage 20

Esse comando altera a porcentagem de computadores que usam um software para 20%.

Parâmetros

-AutoCreateDisabledRule

Especifica se o Configuration Manager cria automaticamente regras de medição de software. Se esse valor for $True, o Configuration Manager criará automaticamente regras de medição de software. Se esse valor for $False, ele não criará regras automaticamente.

Quando o Configuration Manager cria regras, ele as cria como desabilitadas.

Você pode usar os valores definidos por outros parâmetros deste cmdlet para limitar a criação de regras.

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

-AutoCreatePercentage

Especifica uma porcentagem de computadores que usam um software para o Configuration Manager criar uma regra. O medidor de software calcula o número de computadores como todos os computadores monitorados para monitoramento de software pelo Configuration Manager, não apenas para um único site. Os valores válidos são inteiros de 1 a 99.

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

-AutoCreateThreshold

Especifica um número de regras de medição de software como um limite. Quando o Configuration Manager excede esse limite, ele para de criar regras automaticamente. O número de regras contadas para esse limite inclui todas as regras de medição de software, não apenas as que o Configuration Manager cria automaticamente. Os valores válidos são inteiros de 1 a 1000.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DataRetentionDayCount

Especifica o número de dias em que o Configuration Manager mantém dados de medição de software.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Nenhum

Saídas

System.Object