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>]
説明
Set-CMSoftwareMeteringRule コマンドレットは、Configuration Manager のソフトウェア 使用状況測定規則のプロパティを変更し、ソフトウェア測定規則のセキュリティ スコープを追加または削除します。 すべてのルールには、少なくとも 1 つのセキュリティ スコープが必要です。
ソフトウェアメータリングでは、クライアントが特定のソフトウェア プログラムの使用を開始したときや、ユーザーがそのソフトウェアを使用した時間など、Configuration Manager クライアントからソフトウェア使用状況データを監視および収集します。 監視するソフトウェアを指定するソフトウェア測定ルールを作成できます。
ルールのプロパティを変更するには、ID または製品名で変更するルールを指定するか、 Get-CMSoftwareMeteringRule コマンドレットを 使用します。 同様に、指定した ID、製品名、または Get-CMSoftwareMeteringRule を使用して、規則のセキュリティ スコープを変更できます。
Configuration Manager でのソフトウェアメータリングの詳細については、「Configuration Manager での ソフトウェア 使用状況測定の概要」を参照してください。 セキュリティ スコープの詳細については、「 Configuration Manager でのセキュリティの計画」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 製品のルールのロケールを変更する
PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -LanguageID 1036
このコマンドは、製品名アカウンティング パッケージを含むルールのロケール ID を設定します。
例 2: 製品の規則にセキュリティ スコープを追加する
PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -SecurityScopeAction AddMembership -SecurityScopeName "Scope05"
このコマンドは、Scope05 という名前のセキュリティ スコープを製品名 Accounting Package のルールに追加します。
パラメーター
-Comment
ソフトウェア使用状況測定規則のコメントを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FileName
ルールが測定するソフトウェアのファイル名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FileVersion
ルールが測定するソフトウェアのバージョンを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
ソフトウェア測定規則の ID の配列を指定します。
型: | String |
Aliases: | RuleId |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
ソフトウェアメータリングルールオブジェクトを指定します。 ソフトウェア 使用状況測定ルール オブジェクトを取得するには、 Get-CMSoftwareMeteringRule コマンドレットを 使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LanguageId
ルールが測定するソフトウェアの LocaleID を指定します。 ロケール識別子の詳細と一覧については、「 付録 A: 製品の動作」を参照してください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NewProductName
ルールが測定するソフトウェアの新しい名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OriginalFileName
ルールが測定するソフトウェアの元のファイル名を指定します。 ユーザーが名前を変更した場合、このパラメーターは FileName パラメーターとは異なる場合があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
ルールが測定するソフトウェアのファイル パスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ProductName
ルールが測定する製品の名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteCode
Configuration Manager サイトのサイト コードを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object