Share via


Set-CMSoftwareMeteringRule

Altera propriedades e escopos de segurança para Configuration Manager regras de medição de software.

Syntax

Set-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   -InputObject <IResultObject>
   [-LanguageId <Int32>]
   [-NewProductName <String>]
   [-OriginalFileName <String>]
   [-PassThru]
   [-Path <String>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   [-LanguageId <Int32>]
   [-NewProductName <String>]
   [-OriginalFileName <String>]
   [-PassThru]
   [-Path <String>]
   -ProductName <String>
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   -Id <String>
   [-LanguageId <Int32>]
   [-NewProductName <String>]
   [-OriginalFileName <String>]
   [-PassThru]
   [-Path <String>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMSoftwareMeteringRule altera as propriedades para regras de medição de software em Configuration Manager e adiciona ou remove escopos de segurança para regras de medição de software. Cada regra deve ter pelo menos um escopo de segurança.

A medição de software monitora e coleta dados de uso de software de Configuration Manager clientes, como quando os clientes começaram a usar um programa de software específico e há quanto tempo os usuários trabalham com esse software. Você pode criar regras de medição de software que especificam qual software monitorar.

Para alterar as propriedades da regra, você pode especificar regras para alterar por ID ou pelo nome do produto ou usar o cmdlet Get-CMSoftwareMeteringRule . Da mesma forma, você pode alterar o escopo de segurança para regras para ID especificada, nome do produto ou usando Get-CMSoftwareMeteringRule.

Para obter mais informações sobre a medição de software no Configuration Manager, consulte Introdução à Medição de Software no Configuration Manager. Para obter mais informações sobre escopos de segurança, consulte Planejamento para Segurança em Configuration Manager.

Observação

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

Exemplos

Exemplo 1: alterar a localidade para regras de um produto

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -LanguageID 1036

Este comando define a ID da localidade para regras que incluem o nome do produto Pacote contábil.

Exemplo 2: Adicionar um escopo de segurança às regras de um produto

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -SecurityScopeAction AddMembership -SecurityScopeName "Scope05"

Esse comando adiciona o escopo de segurança chamado Scope05 às regras para o pacote de contabilidade do nome do produto.

Parâmetros

-Comment

Especifica um comentário para uma regra de medição de software.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-FileName

Especifica o nome do arquivo do software que um medidor de regra.

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

-FileVersion

Especifica uma versão do software que um medidor de regra.

Type:String
Position:Named
Default value:None
Required:False
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). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

Especifica uma matriz de IDs para regras de medição de software.

Type:String
Aliases:RuleId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica um objeto de regra de medição de software. Para obter um objeto de regra de medição de software, use o cmdlet Get-CMSoftwareMeteringRule .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LanguageId

Especifica uma LocaleID do software que um medidor de regra. Para obter mais informações e uma lista de identificadores de localidade, consulte Apêndice A: Comportamento do Produto.

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

-NewProductName

Especifica um novo nome para o software que um medidor de regra.

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

-OriginalFileName

Especifica um nome de arquivo original do software que um medidor de regra. Esse parâmetro pode ser diferente do parâmetro FileName se um usuário alterou o nome.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-Path

Especifica um caminho de arquivo do software que um medidor de regra.

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

-ProductName

Especifica um nome para um produto que um medidor de regra.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Especifica um código de site de um site Configuration Manager.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object