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コマンドレットを使用して、不要なルールを削除できます。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 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 がルールを作成すると、無効として作成されます。
このコマンドレットの他のパラメーターで設定された値を使用して、ルールの作成を制限できます。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCreatePercentage
Configuration Manager にソフトウェアを使用してルールを作成するコンピューターの割合を指定します。 ソフトウェア メータリングは、1 つのサイトに対してではなく、Configuration Manager によってソフトウェア メータリングを監視しているすべてのコンピューターとしてコンピューターの数を計算します。 有効な値は、1 ~ 99 の整数です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCreateThreshold
ソフトウェア メータリングルールの数をしきい値として指定します。 Configuration Manager がこのしきい値を超えると、ルールの自動作成が停止します。 このしきい値にカウントされるルールの数には、Configuration Manager によって自動的に作成されるルールだけでなく、すべてのソフトウェア メータリング ルールが含まれます。 有効な値は、1 ~ 1000 の整数です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DataRetentionDayCount
Configuration Manager がソフトウェア メータリング データを保持する日数を指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
なし
出力
System.Object