Share via

New-CMSoftwareMeteringRule

  • Referência
Módulo:
ConfigurationManager

Cria uma regra de medição de software Configuration Manager.

Syntax

New-CMSoftwareMeteringRule
   [-Comment <String>]
   [-FileName <String>]
   [-FileVersion <String>]
   [-LanguageId <Int32>]
   [-OriginalFileName <String>]
   -ProductName <String>
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
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 Configuration Manager. Uma regra de medição de software especifica um software, juntamente com informações de versão. Você pode obter informações de arquivo necessárias do Windows Explorer.

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 obter mais informações sobre a medição de software no Configuration Manager, consulte Introdução à Medição de Software no 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: 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        :

Esse comando cria uma regra de medição de software para o site Configuration Manager chamado CM1. O comando especifica o nome do arquivo, a versão, o nome do arquivo original e o nome do produto para o produto de software.

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

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

-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

-OriginalFileName

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

Type:String
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:True
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 para 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

None

Saídas

IResultObject