Set-CMSoftwareMeteringSetting
Configuration Manager ソフトウェア使用状況測定プロパティを構成します。
構文
Set-CMSoftwareMeteringSetting
[-AutoCreateDisabledRule <Boolean>]
[-AutoCreatePercentage <Int32>]
[-AutoCreateThreshold <Int32>]
[-DataRetentionDayCount <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-CMSoftwareMeteringSetting コマンドレットは、Configuration Manager のソフトウェア 使用状況測定プロパティを構成します。
ソフトウェア メータリングでは、ソフトウェア インベントリ情報を使用して、ソフトウェア使用状況測定ルールを作成できます。 この機能を選択すると、Configuration Manager は同じソフトウェアを使用する複数のコンピューターを識別し、その使用状況を追跡するためのルールを作成します。 Configuration Manager がルールの作成に使用するソフトウェア 使用状況測定データを保持する期間を決定します。
Configuration Manager がルールを作成しすぎないようにするには、Configuration Manager がルールを作成する前に、ソフトウェアを使用するコンピューターの割合を指定します。
ルールのしきい値を設定することもできます。 ソフトウェア測定規則の数がこのしきい値を超えた場合、Configuration Manager はルールの自動的な作成を停止します。
Configuration Manager は、ルールを自動的に作成すると、そのルールが無効として作成されます。 無効なルールは、クライアントから情報を収集しません。 Enable-CMSoftwareMeteringRule コマンドレットを使用して、ルールを有効にすることができます。 Remove-CMSoftwareMeteringRule コマンドレットを使用して、不要な規則を削除できます。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 自動ルール作成を無効にする
PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreateDisabledRule $False
このコマンドは、ルールの自動作成を無効にします。 Configuration Manager では、このコマンドを実行した後にソフトウェア使用状況測定ルールが自動的に作成されることはありません。
例 2: ルールの自動作成を構成する
PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreateDisabledRule $True -AutoCreatePercentage 50 -AutoCreateThreshold 200 -DataRetentionDayCount 30
このコマンドは、ルールの自動作成を有効にし、そのプロパティを設定します。 このコマンドは、ソフトウェアを使用するコンピューターの割合を 50% に設定し、ルールのしきい値を 200 に設定し、Configuration Manager がソフトウェア測定データを 30 日に保持する時間を設定します。
例 3: 自動ルール作成の割合を変更する
PS XYZ:\> Set-CMSoftwareMeteringSetting -AutoCreatePercentage 20
このコマンドは、ソフトウェアを使用するコンピューターの割合を 20% に変更します。
パラメーター
-AutoCreateDisabledRule
Configuration Manager でソフトウェア 使用状況測定規則を自動的に作成するかどうかを指定します。 この値が$Trueの場合、Configuration Manager はソフトウェア 使用状況測定規則を自動的に作成します。 この値が$Falseされている場合、ルールは自動的に作成されません。
Configuration Manager によってルールが作成されると、無効として作成されます。
ルールの作成を制限するには、このコマンドレットの他のパラメーターによって設定された値を使用できます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AutoCreatePercentage
Configuration Manager のソフトウェアを使用してルールを作成するコンピューターの割合を指定します。 ソフトウェア メータリングでは、1 つのサイトだけでなく、Configuration Manager によるソフトウェア メータリングで監視されるすべてのコンピューターとしてコンピューターの数が計算されます。 有効な値は、1 から 99 までの整数です。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AutoCreateThreshold
ソフトウェア使用状況測定規則の数をしきい値として指定します。 Configuration Manager がこのしきい値を超えると、自動的にルールの作成が停止します。 このしきい値にカウントされるルールの数には、Configuration Manager によって自動的に作成されるルールだけでなく、すべてのソフトウェア 使用状況測定ルールが含まれます。 有効な値は、1 から 1000 までの整数です。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DataRetentionDayCount
Configuration Manager がソフトウェア使用状況測定データを保持する日数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object