Get-CimClass
特定の名前空間の CIM クラスの一覧を取得します。
構文
Get-CimClass
[[-ClassName] <string>]
[[-Namespace] <string>]
[-Amended]
[-OperationTimeoutSec <uint>]
[-ComputerName <string[]>]
[-MethodName <string>]
[-PropertyName <string>]
[-QualifierName <string>]
[<CommonParameters>]
Get-CimClass
[[-ClassName] <string>]
[[-Namespace] <string>]
-CimSession <CimSession[]>
[-Amended]
[-OperationTimeoutSec <uint>]
[-MethodName <string>]
[-PropertyName <string>]
[-QualifierName <string>]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
Get-CimClass
コマンドレットは、特定の名前空間内の CIM クラスの一覧を取得します。 クラス名が指定されていない場合、コマンドレットは名前空間内のすべてのクラスを返します。 CIM インスタンスとは異なり、CIM クラスには、取得元の CIM セッションまたはコンピューター名は含まれません。
例
例 1: すべてのクラス定義を取得する
この例では、ルート/CIMV2 名前空間のすべてのクラス定義を取得します。
Get-CimClass
例 2: 特定の名前のクラスを取得する
この例では、名前に disk という単語 含むクラスを取得します。
Get-CimClass -ClassName *Disk*
例 3: 特定のメソッド名を持つクラスを取得する
この例では、Win32 名前で始まり、Termで始まるメソッド名を持つクラスを取得します。
Get-CimClass -ClassName Win32* -MethodName Term*
例 4: 特定のプロパティ名を持つクラスを取得する
この例では、Win32 名前で始まり、Handle という名前のプロパティ持つクラスを取得します。
Get-CimClass -ClassName Win32* -PropertyName Handle
例 5: 特定の修飾子名を持つクラスを取得する
次の使用例は、Win32 名前で始まるクラスを取得し、名前に Disk という単語を含み、指定された修飾子 関連付けを持ちます。
Get-CimClass -ClassName Win32*Disk* -QualifierName Association
例 6: 特定の名前空間からクラス定義を取得する
次の使用例は、名前に Net という単語を含むクラス定義を、root/StandardCimv2 指定した名前空間から取得します。
Get-CimClass -Namespace root/StandardCimv2 -ClassName *Net*
例 7: リモート サーバーからクラス定義を取得する
次の使用例は、指定したリモート サーバー Server01 および Server02から、名前に Disk という単語を含むクラス定義を取得します。
Get-CimClass -ClassName *Disk* -ComputerName Server01, Server02
例 8: CIM セッションを使用してクラスを取得する
$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *Disk* -CimSession $s
この一連のコマンドは、複数のコンピューターとのセッションを作成し、$s
コマンドレットを使用して変数 New-CimSession
に格納し、Get-CimClass
コマンドレットを使用してクラスを取得します。
パラメーター
-Amended
CIM クエリから返されるオブジェクトに修正された情報を含める必要があることを示します。 通常、修正された情報は、CIM オブジェクトにアタッチされているオブジェクトやプロパティの説明など、ローカライズ可能な情報です。 これは、数値を人間が判読できる値に変換する場合に便利です。
このパラメーターは PowerShell 7.3 で追加されました。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CimSession
リモート セッションまたはリモート コンピューターでコマンドレットを実行します。 コンピューター名またはセッション オブジェクト (New-CimSession
または Get-CimSession
コマンドレットの出力など) を入力します。 既定値は、ローカル コンピューター上の現在のセッションです。
型: | CimSession[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ClassName
操作を実行する CIM クラスの名前を指定します。 PowerShell はローカル WMI サーバーからクラスの一覧を取得してクラス名の一覧を提供するため、タブ補完を使用してクラスの一覧を参照できます。
型: | String |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-ComputerName
CIM 操作を実行するコンピューターを指定します。 完全修飾ドメイン名 (FQDN) には、NetBIOS 名または IP アドレスを指定できます。
このパラメーターを指定すると、コマンドレットは WsMan プロトコルを使用して、指定されたコンピューターへの一時的なセッションを作成します。
このパラメーターを指定しない場合、コマンドレットはコンポーネント オブジェクト モデル (COM) を使用してローカル コンピューターで操作を実行します。
同じコンピューターで複数の操作が実行されている場合、CIM セッションを使用するとパフォーマンスが向上します。
型: | String[] |
Aliases: | CN, ServerName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-MethodName
この名前に一致するメソッドを持つクラスを検索します。 このパラメーターにはワイルドカード文字を使用できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-Namespace
CIM 操作の名前空間を指定します。 既定の名前空間はルート/CIMV2 です。 PowerShell はローカル WMI サーバーから名前空間の一覧を取得して名前空間の一覧を提供するため、タブ補完を使用して名前空間の一覧を参照できます。
型: | String |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-OperationTimeoutSec
コマンドレットがコンピューターからの応答を待機する時間を指定します。 既定では、このパラメーターの値は 0 です。これは、コマンドレットがサーバーの既定のタイムアウト値を使用することを意味します。
OperationTimeoutSec パラメーターが、堅牢な接続再試行タイムアウトの 3 分未満の値に設定されている場合、OperationTimeoutSec パラメーターの値を超えるネットワーク 障害は復旧できません。これは、クライアントが再接続する前にサーバーでの操作がタイムアウトするためです。
型: | UInt32 |
Aliases: | OT |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PropertyName
この名前に一致するプロパティを持つクラスを検索します。 このパラメーターにはワイルドカード文字を使用できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-QualifierName
クラス レベル修飾子名でクラスをフィルター処理します。 このパラメーターにはワイルドカード文字を使用できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
このコマンドレットは CIM クラス オブジェクトを返します。
メモ
PowerShell には、Get-CimClass
の次のエイリアスが含まれています。
- ウィンドウズ:
gcls
このコマンドレットは、Windows プラットフォームでのみ使用できます。