Set-CMSoftwareMeteringRule

モジュール:

ConfigurationManager

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でのセキュリティの計画」を参照してください。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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

ソフトウェア使用状況測定規則のコメントを指定します。

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

ソフトウェア測定規則の ID の配列を指定します。

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

-InputObject

ソフトウェアメータリングルールオブジェクトを指定します。 ソフトウェア 使用状況測定ルール オブジェクトを取得するには、 Get-CMSoftwareMeteringRule コマンドレットを 使用します。

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

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

関連リンク

• Disable-CMSoftwareMeteringRule
• Enable-CMSoftwareMeteringRule
• Get-CMSoftwareMeteringRule
• New-CMSoftwareMeteringRule
• Remove-CMSoftwareMeteringRule