Get-CimInstance

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

Get-CimInstance コマンドレットは、CIM サーバーからクラスの CIM インスタンスを取得します。 このコマンドレットのクラス名またはクエリを指定できます。 このコマンドレットは、CIM サーバー上に存在する CIM インスタンスのスナップショットを表す 1 つ以上の CIM インスタンス オブジェクトを返します。

InputObject パラメーターが指定されていない場合、コマンドレットは次のいずれかの方法で動作します。

• ComputerName パラメーターも CimSession パラメーターも指定されていない場合、このコマンドレットはコンポーネント オブジェクト モデル (COM) セッションを使用してローカル Windows Management Instrumentation (WMI) で動作します。
• ComputerName パラメーターまたは CimSession パラメーターが指定されている場合、このコマンドレットは、ComputerName パラメーターまたは CimSession パラメーターで指定された CIM サーバーに対して動作します。

InputObject パラメーターが指定されている場合、コマンドレットは次のいずれかの方法で動作します。

• ComputerName パラメーターも CimSession パラメーターも指定されていない場合、このコマンドレットは入力オブジェクトの CIM セッションまたはコンピューター名を使用します。
• ComputerName パラメーターまたは CimSession パラメーターが指定されている場合、このコマンドレットは CimSession パラメーター値または ComputerName パラメーター値を使用します。

この例では、Win32_Processという名前のクラスの CIM インスタンスを取得します。

Get-CimInstance -ClassName Win32_Process

次の使用例は、WMI サーバー上の ルート 名前空間の下にある名前空間の一覧を取得します。

Get-CimInstance -Namespace root -ClassName __Namespace

この例では、Query パラメーターで指定されたクエリを使用して、Win32_Process という名前のクラスの文字 P で始まるすべての CIM インスタンスを取得します。

Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'P%'"

この例では、Filter パラメーターを使用して、Win32_Process という名前のクラスの文字 P で始まるすべての CIM インスタンスを取得します。

Get-CimInstance -ClassName Win32_Process -Filter "Name like 'P%'"

この例では、キー プロパティ を使用して @{ "Handle"=0 } という名前のクラスのメモリに新しい CIM インスタンスを作成し、$xという名前の変数に格納します。 変数は CIM インスタンスとして Get-CimInstance コマンドレットに渡され、特定のインスタンスを取得します。

$instance = @{
    ClassName = 'Win32_Process'
    Namespace = 'root/cimv2'
    Properties = @{
        Handle = 0
    }
    Key = 'Handle'
    ClientOnly = $true
}
$x = New-CimInstance @instance
Get-CimInstance -CimInstance $x

この例では、Win32_Process という名前のクラスの CIM インスタンスを取得し、変数 $x および $yに格納します。 その後、$x 変数は、名の と kernelModeTime プロパティのみを含むテーブルに書式設定され、テーブル AutoSizeに設定されます。

$x, $y = Get-CimInstance -ClassName Win32_Process
$x | Format-Table -Property Name, KernelModeTime -AutoSize

Name                 KernelModeTime
----                 --------------
System Idle Process 157238797968750

この例では、Win32_ComputerSystem という名前のクラスの CIM インスタンスを、Server01 および Server02という名前のリモート コンピューターから取得します。

Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01, Server02

この例では、オブジェクトとネットワーク トラフィックのサイズを小さくするキー プロパティのみを取得します。

$x = Get-CimInstance -Class Win32_Process -KeyOnly
$x | Invoke-CimMethod -MethodName GetOwner

この例では、プロパティのサブセットのみを取得します。これにより、オブジェクトとネットワーク トラフィックのサイズが小さくなります。

Get-CimInstance -Class Win32_Process -Property Name, KernelModeTime
$x = Get-CimInstance -Class Win32_Process -Property Name, KernelModeTime
$x | Invoke-CimMethod -MethodName GetOwner

Property パラメーターを使用して取得したインスタンスは、Set-CimInstance や Invoke-CimMethodなどの他の CIM 操作を実行するために使用できます。

この例では、 コマンドレットを使用して Server01 および New-CimSession という名前のコンピューターに CIM セッションを作成し、セッション情報を $sという名前の変数に格納します。 変数の内容は、Get-CimInstance パラメーターを使用して に渡され、Win32_ComputerSystemという名前のクラスの CIM インスタンスを取得します。

$s = New-CimSession -ComputerName Server01, Server02
Get-CimInstance -ClassName Win32_ComputerSystem -CimSession $s

CimInstance

CIM インスタンス オブジェクトをこのコマンドレットにパイプできます。

CimInstance

このコマンドレットは、CIM サーバー上の CIM インスタンスのスナップショットを表す 1 つ以上の CIM インスタンス オブジェクトを返します。

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

• ウィンドウズ：
  • gcim

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