Set-CMSoftwareMeteringRule

  • 參考
模組:
ConfigurationManager

變更軟體計量規則Configuration Manager屬性和安全性範圍。

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

Set-CMSoftwareMeteringRule Cmdlet 會變更Configuration Manager中軟體計量規則的屬性，並新增或移除軟體計量規則的安全性範圍。 每個規則至少必須有一個安全性範圍。

軟體計量會監視及收集來自Configuration Manager用戶端的軟體使用量資料，例如用戶端開始使用特定軟體程式的時間，以及使用者使用該軟體的時間長度。 您可以建立軟體計量規則，以指定要監視的軟體。

若要變更規則屬性，您可以指定要依識別碼或產品名稱變更的規則，或使用 Get-CMSoftwareMeteringRule Cmdlet。 同樣地，您可以變更指定識別碼、產品名稱或 Get-CMSoftwareMeteringRule規則的安全性範圍。

如需Configuration Manager中軟體計量的詳細資訊，請參閱Configuration Manager 中的軟體計量簡介。 如需安全性範圍的詳細資訊，請參閱規劃Configuration Manager中的安全性。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：變更產品規則的地區設定

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

此命令會設定包含產品名稱 Accounting Package 之規則的地區設定識別碼。

範例 2：將安全性範圍新增至產品的規則

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

此命令會將名為 Scope05 的安全性範圍新增至產品名稱 Accounting Package 的規則。

參數

-Comment

指定軟體計量規則的批註。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將其與 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

指定規則計量的軟體版本。

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

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

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

-Id

指定軟體計量規則的識別碼陣列。

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

-InputObject

指定軟體計量規則物件。 若要取得軟體計量規則物件，請使用 Get-CMSoftwareMeteringRule Cmdlet。

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

-LanguageId

指定規則計量的軟體 LocaleID。 如需詳細資訊和地區設定識別碼清單，請參閱 附錄 A：產品行為。

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

-NewProductName

為規則計量的軟體指定新名稱。

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

-OriginalFileName

指定規則計量的軟體原始檔案名。 如果使用者變更了名稱，這個參數可能會與 FileName 參數不同。

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

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

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

-Path

指定規則計量的軟體檔案路徑。

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

-ProductName

指定規則計量的產品名稱。

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

-SiteCode

指定Configuration Manager網站的月臺碼。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object