Share via

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

この例では、名前空間 ルート/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: 特定の名前空間からクラス定義を取得する

この例では、指定した名前空間ルート/standardCimv2 から、名前に Net という単語を含むクラス定義を取得します。

Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*

例 7: リモート サーバーからクラス定義を取得する

この例では、指定したリモート サーバー Server01 と Server02 から、名前に単語ディスクを含むクラス定義を取得します。

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 で追加されました。

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

-CimSession

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。 コンピューター名またはセッション オブジェクト (コマンドレットの出力など) をNew-CimSessionGet-CimSession入力します。 既定値は、ローカル コンピューターで実行中の現在のセッションです。

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClassName

操作を実行する CIM クラスの名前を指定します。 PowerShell はローカル WMI サーバーからクラスの一覧を取得してクラス名の一覧を提供するため、タブ補完を使用してクラスの一覧を参照できます。

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

-ComputerName

CIM 操作を実行するコンピューターを指定します。 完全修飾 doメイン 名 (FQDN) に NetBIOS 名または IP アドレスを指定できます。

このパラメーターを指定すると、コマンドレットは WsMan プロトコルを使用して、指定されたコンピューターへの一時的なセッションを作成します。

このパラメーターを指定しない場合、コマンドレットはコンポーネント オブジェクト モデル (COM) を使用してローカル コンピューターで操作を実行します。

同じコンピューターで複数の操作が実行されている場合、CIM セッションを使用するとパフォーマンスが向上します。

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MethodName

この名前に一致するメソッドを持つクラスを検索します。 このパラメーターでは、ワイルドカード文字を使用できます。

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

-Namespace

CIM 操作の名前空間を指定します。 既定の名前空間は root/cimv2 です。 PowerShell はローカル WMI サーバーから名前空間の一覧を取得して名前空間の一覧を提供するため、タブ補完を使用して名前空間の一覧を参照できます。

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

-OperationTimeoutSec

コマンドレットがコンピューターからの応答を待機する時間を指定します。 既定では、このパラメーターの値は 0 です。これは、コマンドレットがサーバーの既定のタイムアウト値を使用することを意味します。

OperationTimeoutSec パラメーターが、堅牢な接続再試行タイムアウトの 3 分未満の値に設定されている場合、クライアントが再接続する前にサーバー上の操作がタイムアウトするため、OperationTimeoutSec パラメーターの値を超えるネットワーク 障害は復旧できません。

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

-PropertyName

この名前に一致するプロパティを持つクラスを検索します。 このパラメーターでは、ワイルドカード文字を使用できます。

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

-QualifierName

クラス レベル修飾子名でクラスをフィルター処理します。 このパラメーターでは、ワイルドカード文字を使用できます。

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

入力

None

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

出力

CimClass

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

メモ

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

  • Windows:
    • gcls

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