Partilhar via


New-CMSoftwareMeteringRule

SYNOPSIS

Cria uma regra de medição de software do Gestor de Configuração.

SYNTAX

Novo (Predefinido)

New-CMSoftwareMeteringRule [-Comment <String>] [-FileName <String>] [-FileVersion <String>]
 [-LanguageId <Int32>] [-OriginalFileName <String>] -ProductName <String> [-SiteCode <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NovoFromPath

New-CMSoftwareMeteringRule -Path <String> [-ProductName <String>] [-SiteCode <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

O cmdlet New-CMSoftwareMeteringRule cria uma regra de medição de software do Gestor de Configuração. Uma regra de medição de software especifica uma peça de software, juntamente com informações de versão. Pode obter informações de ficheiros necessárias do Windows Explorer.

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

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: Criar uma regra de medição de software

PS XYZ:\> New-CMSoftwareMeteringRule -Path "Notepad.exe" -SiteCode "CM1" -FileVersion "6.1.7600.16385" -OriginalFileName "NOTEPAD.EXE" -ProductName "Microsoft Windows Operating System"
ApplyToChildSites : True
Comment           :
Enabled           : True
FileName          : Notepad.exe
FileVersion       : 6.1.7600.16385
LanguageID        :
LastUpdateTime    :
OriginalFileName  : NOTEPAD.EXE
ProductName       : Microsoft Windows Operating System
RuleID            :
SecurityKey       :
SiteCode          : CM1
SourceSite        :

Este comando cria uma regra de medição de software para o site do Gestor de Configuração chamado CM1. O comando especifica o nome do ficheiro, versão, nome original do ficheiro e nome do produto para o produto de software.

PARAMETERS

-Comentário

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

Type: String
Parameter Sets: New
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

Type: String
Parameter Sets: New
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: New
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

-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: New
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 Path se um utilizador alterar o nome.

Type: String
Parameter Sets: New
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: NewFromPath
Aliases:

Required: True
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: New
Aliases:

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

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

- SiteCode

Especifica um código de site para um site do Gestor de Configuração.

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

Nenhuma

OUTPUTS

IResultObject#SMS_MeteredProductRule

NOTAS

Desativar CMSoftwareMeteringRule

Enable-CMSoftwareMeteringRule

Get-CMSoftwareMeteringRule

Remover-CMSoftwareMeteringRule

Set-CMSoftwareMeteringRule