Get-CimClass

モジュール:

CimCmdlets

特定の名前空間の 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: すべてのクラス定義を取得する

この例では、名前空間 root/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 という単語を含み、指定された修飾子 Associationを持つクラスを取得します。

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

この一連のコマンドは、複数のコンピューターとのセッションを作成し、New-CimSession コマンドレットを使用して変数$sに格納し、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 操作の名前空間を指定します。 既定の名前空間は root/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

このコマンドレットにオブジェクトをパイプすることはできません。

出力

CimClass

このコマンドレットは CIM クラス オブジェクトを返します。

メモ

PowerShell には、 Get-CimClassの次のエイリアスが含まれています。

• Windows:
  • gcls

このコマンドレットは、Windows プラットフォームでのみ使用できます。

関連リンク

• New-CimSession