Set-CMSoftwareMeteringRule
變更 Configuration Manager 軟體計量規則的屬性和安全性範圍。
語法
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 中的軟體計量簡介。 如需安全性範圍的詳細資訊,請參閱 Planning for Security in 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
指定軟體計量規則的批注。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-FileName
指定規則計量的軟體檔名。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-FileVersion
指定規則計量的軟體版本。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Id
指定軟體計量規則的識別碼數位。
類型: | String |
別名: | RuleId |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定軟體計量規則物件。 若要取得軟體計量規則物件,請使用 Get-CMSoftwareMeteringRule Cmdlet。
類型: | IResultObject |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-LanguageId
指定規則計量的軟體 LocaleID。 如需詳細資訊和地區設定標識符清單,請參閱 附錄 A:產品行為。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NewProductName
為規則計量的軟體指定新名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-OriginalFileName
指定規則計量的軟體原始檔名。 如果使用者變更了名稱,這個參數可能會與 FileName 參數不同。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
指定規則計量的軟體檔案路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ProductName
指定規則計量的產品名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-SiteCode
指定 Configuration Manager 月臺的月臺碼。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object