Get-CimAssociatedInstance

Get-CimAssociatedInstance
    [[-Association] <String>]
    [-InputObject] <CimInstance>
    [-ResultClassName <String>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-KeyOnly]
    [<CommonParameters>]

Get-CimAssociatedInstance
    [[-Association] <String>]
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResultClassName <String>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ResourceUri <Uri>]
    [-KeyOnly]
    [<CommonParameters>]

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

Get-CimAssociatedInstance コマンドレットは、関連付けによって、ソース インスタンスと呼ばれる特定の CIM インスタンスに接続されている CIM インスタンスを取得します。

アソシエーションでは、各 CIM インスタンスには名前付きロールがあり、同じ CIM インスタンスが異なるロールのアソシエーションに参加できます。

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

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

$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]

この一連のコマンドは、Win32_LogicalDisk という名前のクラスのインスタンスを取得し、$disk コマンドレットを使用して Get-CimInstance という名前の変数に情報を格納します。 その後、変数内の最初の論理ディスク インスタンスが、指定された CIM インスタンスのすべての関連 CIM インスタンスを取得するために、Get-CimAssociatedInstance コマンドレットの入力オブジェクトとして使用されます。

$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition

この一連のコマンドは、Win32_LogicalDisk クラスのすべてのインスタンスを取得し、$diskという名前の変数に格納します。 次に、変数内の最初の論理ディスク インスタンスが、指定された関連付けクラス Get-CimAssociatedInstanceを介して関連付けられているすべての関連インスタンスを取得するために、 コマンドレットの入力オブジェクトとして使用されます。

この一連のコマンドは、Winmgmt サービスに依存するサービスを取得し、$sという名前の変数に格納します。 Get-CimAssociatedInstance は、取得した関連付けクラスの関連付けられたインスタンスを取得します。

$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

ProcessId Name            StartMode State   Status ExitCode
--------- ----            --------- -----   ------ --------
1716      RpcSs           Auto      Running OK     0
9964      CcmExec         Auto      Running OK     0
0         HgClientService Manual    Stopped OK     1077
0         smstsmgr        Manual    Stopped OK     1077
3396      vmms            Auto      Running OK     0

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

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

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

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

• ウィンドウズ：
  • gcai

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