New-CMSoftwareMeteringRule
Configuration Manager ソフトウェア使用状況測定規則を作成します。
構文
New-CMSoftwareMeteringRule
[-Comment <String>]
[-FileName <String>]
[-FileVersion <String>]
[-LanguageId <Int32>]
[-OriginalFileName <String>]
-ProductName <String>
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareMeteringRule
-Path <String>
[-ProductName <String>]
[-SiteCode <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
New-CMSoftwareMeteringRule コマンドレットは、Configuration Manager ソフトウェア 測定規則を作成します。 ソフトウェアメータリングルールは、バージョン情報と共にソフトウェアの一部を指定します。 Windows エクスプローラーから必要なファイル情報を取得できます。
ソフトウェアメータリングでは、クライアントが特定のソフトウェア プログラムの使用を開始したときや、ユーザーがそのソフトウェアを使用した時間など、Configuration Manager クライアントからソフトウェア使用状況データを監視および収集します。 監視するソフトウェアを指定するソフトウェア測定ルールを作成できます。
Configuration Manager でのソフトウェアメータリングの詳細については、「Configuration Manager での ソフトウェア 使用状況測定の概要」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ソフトウェア 使用状況測定規則を作成する
PS XYZ:\> New-CMSoftwareMeteringRule -Path "Notepad.exe" -SiteCode "CM1" -FileVersion "6.1.7600.16385" -OriginalFileName "NOTEPAD.EXE" -ProductName "Microsoft Windows Operating System"
ApplyToChildSites : True
Comment :
Enabled : True
FileName : Notepad.exe
FileVersion : 6.1.7600.16385
LanguageID :
LastUpdateTime :
OriginalFileName : NOTEPAD.EXE
ProductName : Microsoft Windows Operating System
RuleID :
SecurityKey :
SiteCode : CM1
SourceSite :このコマンドは、CM1 という名前の Configuration Manager サイトのソフトウェア 使用状況測定規則を作成します。 コマンドは、ソフトウェア製品のファイル名、バージョン、元のファイル名、製品名を指定します。
パラメーター
-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 |
-LanguageId
ルールが測定するソフトウェアの LocaleID を指定します。 ロケール識別子の詳細と一覧については、「 付録 A: 製品の動作」を参照してください。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OriginalFileName
ルールが測定するソフトウェアの元のファイル名を指定します。 ユーザーが名前を変更した場合、このパラメーターは Path パラメーターとは異なる場合があります。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
ルールが測定するソフトウェアのファイル パスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | 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 |
入力
None
出力
IResultObject