Set-CMSoftwareMeteringSetting

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

Description

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

A medição de software pode utilizar informações de inventário de software para criar regras de medição de software. Quando seleciona esta funcionalidade, o Configuration Manager identifica vários computadores que utilizam o mesmo software e cria uma regra para controlar essa utilização. Decide quanto tempo deve manter os dados de medição de software que o Configuration Manager utiliza para criar regras.

Para impedir que o Configuration Manager crie demasiadas regras, pode especificar a percentagem de computadores que utilizam uma parte do software antes de o Configuration Manager criar uma regra.

Também pode definir um limiar de regra. Se o número de regras de medição de software exceder este limiar, o Configuration Manager deixa de criar regras automaticamente.

Quando o Configuration Manager cria uma regra automaticamente, cria essa regra como desativada. Uma regra desativada não recolhe informações de clientes. Pode utilizar o cmdlet Enable-CMSoftwareMeteringRule para ativar uma regra. Pode utilizar o cmdlet Remove-CMSoftwareMeteringRule para remover regras indesejadas.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

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

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

Este comando desativa a criação automática de regras. O Configuration Manager não cria automaticamente regras de medição de software depois de 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

Este comando permite a criação automática de regras e define propriedades para a mesma. Este comando define a percentagem de computadores que utilizam uma parte do software para 50%, o limiar da regra para 200 e a quantidade de tempo que o Configuration Manager mantém os dados de medição de software para 30 dias.

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

PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreatePercentage 20

Este comando altera a percentagem de computadores que utilizam uma parte do software para 20%.

Parâmetros

-AutoCreateDisabledRule

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

Quando o Configuration Manager cria regras, cria-as como desativadas.

Pode utilizar os valores definidos por outros parâmetros deste cmdlet para limitar a criação de regras.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoCreatePercentage

Especifica uma percentagem de computadores que utilizam uma parte do software para o Configuration Manager criar uma regra. A medição de software calcula o número de computadores como todos os computadores monitorizados para medição de software pelo Configuration Manager e não apenas para um único site. Os valores válidos são números inteiros de 1 a 99.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoCreateThreshold

Especifica uma série de regras de medição de software como um limiar. Quando o Configuration Manager excede este limiar, deixa de criar regras automaticamente. O número de regras contabilizadas para este limiar inclui todas as regras de medição de software e não apenas as que o Configuration Manager cria automaticamente. Os valores válidos são números inteiros de 1 a 1000.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DataRetentionDayCount

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object