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:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: 製品のルールのロケールを変更する

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -LanguageID 1036

このコマンドは、製品名アカウンティング パッケージを含むルールのロケール ID を設定します。

例 2: 製品のルールにセキュリティ スコープを追加する

PS XYZ:\> Set-CMSoftwareMeteringRule -ProductName "Accounting Package" -SecurityScopeAction AddMembership -SecurityScopeName "Scope05"

このコマンドは、製品名 Accounting Package のルールに Scope05 というセキュリティ スコープを追加します。

パラメーター

-Comment

ソフトウェア メータリング ルールのコメントを指定します。

Type:	String
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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

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

-FileName

ルールが設定するソフトウェアのファイル名を指定します。

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

-FileVersion

ルールが設定するソフトウェアのバージョンを指定します。

Type:	String
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

-Id

ソフトウェア メータリング ルールの ID の配列を指定します。

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

-InputObject

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

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LanguageId

ルールが設定するソフトウェアの LocaleID を指定します。 ロケール識別子の詳細と一覧については、「 付録 A: Product Behavior」を参照してください。

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

-NewProductName

ルールが設定するソフトウェアの新しい名前を指定します。

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

-OriginalFileName

ルールが設定するソフトウェアの元のファイル名を指定します。 ユーザーが名前を変更した場合、このパラメーターは FileName パラメーターとは異なる場合があります。

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

-PassThru

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

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

-Path

ルールが設定するソフトウェアのファイル パスを指定します。

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

-ProductName

ルールが適用される製品の名前を指定します。

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

-SiteCode

Configuration Manager サイトのサイト コードを指定します。

Type:	String
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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

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