Get-CimAssociatedInstance
擷取關聯連接到特定 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 Cmdlet 會依關聯，擷取連線到稱為來源實例的特定 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 Cmdlet 的輸入物件，以取得指定 CIM 實例的所有相關聯 CIM 實例。
範例 2：取得特定類型的所有相關聯實例
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition
這組命令會擷取 Win32_LogicalDisk 類別的所有實例，並將其儲存在名為 $disk的變數中。 變數中的第一個邏輯磁碟實例接著會作為 Get-CimAssociatedInstance Cmdlet 的輸入物件，以取得透過指定關聯類別相關聯的所有相關聯實例 Win32_DiskPartition。
範例 3：透過特定類別的限定符取得所有相關聯的實例
$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
Get-CimClass -ClassName *Service* -Qualifier "Association"
$c.CimClasName
Win32_LoadOrderGroupServiceDependencies
Win32_DependentService
Win32_SystemServices
Win32_LoadOrderGroupServiceMembers
Win32_ServiceSpecificationService
Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService
這組命令檢索依賴於 WMI 服務的服務，並將它們存儲在名為 $s的變數中。 通過指定 Association 作為限定符，使用 cmdlet 檢索Get-CimClassWin32_DependentService的關聯類名稱，然後與 $s一起傳遞給 Get-CimAssociatedInstance cmdlet，以獲取檢索到的關聯類的所有關聯實例。
參數
-Association
指定關聯類別的名稱。 如果未指定此參數，則 cmdlet 將返回任何類型的所有現有關聯物件。
例如，如果類別 A 透過兩個關聯與 B 類別相關聯，AB1 和 AB2，則可以使用此參數來指定關聯類型，例如 AB1 或 AB2。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-CimSession
使用指定的 CIM 作業階段執行命令。 輸入包含 CIM 工作階段的變數，或建立或取得 CIM 工作階段的命令，例如 New-CimSession 或 Get-CimSession。 如需詳細資訊，請參閱 about_CimSession。
參數屬性
| 類型: | |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
SessionSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ComputerName
指定您要執行 CIM 作業的電腦名稱。 您可以指定完全合格的網域名稱（FQDN）或 NetBIOS 名稱。
如果您指定此參數，Cmdlet 會使用 WsMan 通訊協定，為指定的電腦建立暫存會話。
如果您未指定此參數，Cmdlet 會使用元件物件模型 （COM） 在本機計算機上執行作業。
如果在相同電腦上執行多個作業，則使用 CIM 作業進行連線可提供更佳的效能。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 中國, 伺服器名稱 |
參數集
ComputerSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
指定此 Cmdlet 的輸入。 您可以使用此參數，或者您可以使用管線將輸入傳送至此 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 作業的命名空間。 默認命名空間為 root/cimv2。
備註
您可以使用標籤補全功能來瀏覽命名空間清單，因為 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_LogicalDiskhttp://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 實例。
根據預設，此參數的值是 Null，而且會傳回所有相關聯的 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 不接受任何輸入物件。
輸出
Object
此 Cmdlet 會傳回 物件。