Set-CMSoftwareMeteringSetting
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