Set-CMSoftwareMeteringRule

Modifica le proprietà e gli ambiti di sicurezza per le regole di controllo software di Configuration Manager.

Sintassi

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

Descrizione

Il cmdlet Set-CMSoftwareMeteringRule modifica le proprietà per le regole di misurazione software in Configuration Manager e aggiunge o rimuove gli ambiti di sicurezza per le regole di misurazione software. Ogni regola deve avere almeno un ambito di sicurezza.

La misurazione software monitora e raccoglie i dati di utilizzo del software dai client di Configuration Manager, ad esempio quando i client hanno iniziato a usare un determinato programma software e per quanto tempo gli utenti hanno lavorato con tale software. È possibile creare regole di misurazione software che specificano il software da monitorare.

Per modificare le proprietà delle regole, è possibile specificare regole da modificare in base all'ID o al nome del prodotto oppure usare il cmdlet Get-CMSoftwareMeteringRule . Analogamente, è possibile modificare l'ambito di sicurezza per le regole per l'ID specificato, il nome del prodotto o tramite Get-CMSoftwareMeteringRule.

Per altre informazioni sulla misurazione software in Configuration Manager, vedere Introduzione alla misurazione software in Configuration Manager. Per altre informazioni sugli ambiti di sicurezza, vedere Planning for Security in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare le impostazioni locali per le regole per un prodotto

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

Questo comando imposta l'ID delle impostazioni locali per le regole che includono il nome del prodotto Accounting Package.

Esempio 2: Aggiungere un ambito di sicurezza alle regole per un prodotto

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

Questo comando aggiunge l'ambito di sicurezza denominato Scope05 alle regole per il nome del prodotto Accounting Package.

Parametri

-Comment

Specifica un commento per una regola di misurazione software.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FileName

Specifica il nome file del software misurato da una regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FileVersion

Specifica una versione del software misurata da una regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica una matrice di ID per le regole di controllo software.

Tipo:String
Alias:RuleId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto regola di misurazione software. Per ottenere un oggetto regola di controllo software, usare il cmdlet Get-CMSoftwareMeteringRule .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LanguageId

Specifica un VALORE LocaleID del software misurato da una regola. Per altre informazioni e un elenco degli identificatori delle impostazioni locali, vedere Appendice A: Comportamento del prodotto.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewProductName

Specifica un nuovo nome per il software misurato da una regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OriginalFileName

Specifica un nome file originale del software misurato da una regola. Questo parametro può essere diverso dal parametro FileName se un utente ha modificato il nome.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica un percorso di file del software misurato da una regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProductName

Specifica un nome per un prodotto misurato da una regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SiteCode

Specifica un codice del sito di un sito di Configuration Manager.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object