Get-CimAssociatedInstance

模組:

CimCmdlets Module

擷取透過關聯與特定 CIM 實例相連的 CIM 實例。

語法

ComputerSet (預設值)

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

SessionSet

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

Description

此 Cmdlet 只能在 Windows 平臺上使用。

Get-CimAssociatedInstance指令本擷取透過關聯取得與特定 CIM 實例（稱為來源實例）相連的 CIM 實例。

在關聯中，每個 CIM 實例都有命名角色，且同一個 CIM 實例可以以不同角色參與關聯。

若未指定 InputObject 參數，該 cmdlet 可以以下方式之一運作：

• 如果未指定 ComputerName 參數或 CimSession 參數，則此 Cmdlet 會使用元件物件模型 （COM） 會話在本機 Windows Management Instrumentation （WMI） 上運作。
• 如果指定 ComputerName 參數或 CimSession 參數，則此 Cmdlet 會針對 ComputerName 參數或 CimSession 參數所指定的 CIM 伺服器運作。

範例

範例 1：取得特定實例的所有相關實例

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

這組指令會擷取名為 Win32_LogicalDisk 的類別實例，並將資訊儲存在使用 $disk cmdlet 命名Get-CimInstance的變數中。 變數中的第一個邏輯磁碟實例會被用作指令長的輸入物件 Get-CimAssociatedInstance ，以取得指定 CIM 實例的所有相關 CIM 實例。

範例 2：取得特定類型的所有相關實例

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

這組指令會擷取 Win32_LogicalDisk 類別的所有實例，並將其儲存在名為 $disk的變數中。 變數中的第一個邏輯磁碟實例會作為 cmdlet 的輸入物件 Get-CimAssociatedInstance ，以取得透過指定關聯類別 Win32_DiskPartition 所關聯的所有相關實例。

範例 3：透過特定類別的限定符取得所有相關實例

這組指令會擷取依賴 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

參數

-Association

指定關聯類別的名稱。 如果你沒有指定這個參數，指令長會回傳所有現有的關聯物件，不論類型如何。

例如，若類別 A 透過兩個關聯 AB1 和 AB2 與類別 B 相關聯，則此參數可用來指定關聯類型，為 AB1 或 AB2。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-CimSession

使用指定的 CIM 作業階段執行命令。 輸入包含 CIM 會話的變數，或建立或取得 CIM 會話的指令，例如 New-CimSession 或 Get-CimSession。 如需詳細資訊，請參閱 about_CimSession。

參數屬性

類型:	CimSession[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SessionSet

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ComputerName

指定您要執行 CIM 作業的電腦名稱。 您可以指定完全合格的網域名稱（FQDN）或 NetBIOS 名稱。

如果您指定此參數，Cmdlet 會使用 WsMan 通訊協定，為指定的電腦建立暫存會話。

如果你沒有指定這個參數，指令長會在本地電腦上使用 Component Object Model（COM）執行這個操作。

如果在相同電腦上執行多個作業，則使用 CIM 作業進行連線可提供更佳的效能。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	中國, 伺服器名稱

參數集

ComputerSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

指定此指令的輸入。 你可以使用這個參數，或者將輸入到這個 cmdlet。

InputObject 參數不進行集合的列舉操作。 如果傳遞集合，就會拋出錯誤。 使用資料集合時，透過管道傳送輸入以列舉值。

參數屬性

類型:	CimInstance
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	CimInstance

參數集

(All)

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-KeyOnly

回傳僅填充關鍵屬性的物件。 這減少了網路傳輸的資料量。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Namespace

指定 CIM 作業的命名空間。 預設命名空間 根/CIMV2。

Note

您可以使用標籤補全功能來瀏覽命名空間清單，因為 PowerShell 會從本機 WMI 伺服器獲取命名空間來提供此清單。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OperationTimeoutSec

指定 Cmdlet 等候電腦回應的時間量。 根據預設，此參數的值是0，這表示 Cmdlet 會使用伺服器的預設逾時值。

如果 OperationTimeoutSec 參數設定為小於 3 分鐘的穩固連線重試逾時，則當網路故障持續時間超過 OperationTimeoutSec 參數的值時，將無法復原，因為伺服器上的操作會在客戶端重新連接之前超時。

參數屬性

類型:	UInt32
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	OT

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ResourceUri

指定資源類別或實例的資源統一資源標識碼（URI）。 URI 可用來識別電腦上的特定資源類型，例如磁碟或進程。

URI 包含前置詞和資源的路徑。 例如：

• http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
• http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

預設情況下，如果你沒有指定這個參數，就會使用 DMTF 標準資源 URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ ，並加上類別名稱。

ResourceUri 只能與使用 WSMan 通訊協定建立的 CIM 會話搭配使用，或在指定使用 WSMan 建立 CIM 會話的 ComputerName 參數時使用。 如果你指定這個參數但未指定 ComputerName 參數，或是指定使用 DCOM 協定建立的 CIM 會話，會發生錯誤，因為 DCOM 協定不支援 ResourceUri 參數。

如果同時指定 ResourceUri 參數和 Filter 參數，則會忽略 Filter 參數。

參數屬性

類型:	Uri
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResultClassName

指定相關實例的類別名稱。 CIM 實例可以與一個或多個 CIM 實例相關聯。 如果你沒有指定結果類別名稱，所有相關的 CIM 實例都會被回傳。

預設情況下，此參數的值為空，所有相關的 CIM 實例都會被回傳。

你可以將關聯結果篩選成符合特定類別名稱。 過濾是在伺服器端進行的。 若未指定此參數，則 Get-CimAssociatedInstance 回傳所有現有關聯。 例如，若類別 A 與類別 B、C 和 D 相關聯，則可用此參數限制輸出為特定類型（B、C 或 D）。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

您不能將物件透過管道傳送到此 Cmdlet。

輸出

CimInstance

此指令檔回傳一個 CIM 實例物件。

備註

PowerShell 包含下列 Get-CimAssociatedInstance的別名：

• 窗戶：
  • gcai

此 Cmdlet 僅適用於 Windows 平臺。

相關連結

• Get-CimClass
• Get-CimInstance