Partilhar via


Set-CMSoftwareMeteringRule

SYNOPSIS

Altera propriedades e âmbitos de segurança para as regras de medição de software do Gestor de Configuração.

SYNTAX

SetByValueMandatory (Padrão)

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>]

SetByName

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>]

SetById

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 as regras de medição de software no Gestor de Configuração e adiciona ou remove os âmbitos de segurança para as regras de medição de software. Todas as regras devem ter pelo menos uma margem de segurança.

A medição de software monitoriza e recolhe dados de utilização de software a partir de clientes do Gestor de Configuração, como quando os clientes começaram a usar um determinado programa de software e quanto tempo os utilizadores trabalharam com esse software. Pode criar regras de medição de software que especifiquem qual o software a monitorizar.

Para alterar propriedades de regras, pode especificar regras para alterar por ID ou pelo nome do produto, ou utilizar o cmdlet Get-CMSoftwareMeteringRule. Da mesma forma, pode alterar o âmbito de segurança para regras para identificação especificada, nome do produto ou usando o Get-CMSoftwareMeteringRule.

Para obter mais informações sobre a medição de software no Gestor de Configuração, consulte Introdução à Medidor de Software no Gestor de Configuração. Para obter mais informações sobre os âmbitos de segurança, consulte Planeamento para Segurança no Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Alterar local para regras para um produto

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

Este comando define o ID local para regras que incluem o pacote contabilístico de nome do produto.

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

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

Este comando adiciona o âmbito de segurança chamado Scope05 às regras para o pacote contabilístico de nome do produto.

PARAMETERS

-Comentário

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Nome de arquivo

Especifica o nome de ficheiro do software que uma regra medi.

Type: String
Parameter Sets: (All)
Aliases:

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

-Imagem de Arquivo

Especifica uma versão do software que uma regra medi.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- ID

Especifica uma série de IDs para regras de medição de software.

Type: String
Parameter Sets: SetById
Aliases: RuleId

Required: True
Position: Named
Default value: None
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, utilize o cmdlet Get-CMSoftwareMeteringRule.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-LanguageId

Especifica um LocaleID do software que uma regra medi. Para obter mais informações e uma lista de identificadores locais, consulte o apêndice A: Comportamento do produto.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-NewProductName

Especifica um novo nome para o software que uma regra medi.

Type: String
Parameter Sets: (All)
Aliases:

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

-OriginalFileName

Especifica um nome original do ficheiro do software que uma regra medi. Este parâmetro pode diferir do parâmetro FileName se um utilizador alterar o nome.

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Especifica um caminho de ficheiro do software que uma regra medi.

Type: String
Parameter Sets: (All)
Aliases:

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

-Nome do produto

Especifica um nome para um produto que uma regra medi.

Type: String
Parameter Sets: SetByName
Aliases:

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

- SiteCode

Especifica um código de site de um site do Gestor de Configurações.

Type: String
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Desativar CMSoftwareMeteringRule

Enable-CMSoftwareMeteringRule

Get-CMSoftwareMeteringRule

Novo CMSoftwareMeteringRule

Remover-CMSoftwareMeteringRule