Get-CimAssociatedInstance
연결에 의해 특정 CIM 인스턴스에 연결된 CIM 인스턴스를 검색합니다.
구문
Get-CimAssociatedInstance
[[-Association] <String>]
[-ResultClassName <String>]
[-InputObject] <CimInstance>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-ResourceUri <Uri>]
[-ComputerName <String[]>]
[-KeyOnly]
[<CommonParameters>] Get-CimAssociatedInstance
[[-Association] <String>]
[-ResultClassName <String>]
[-InputObject] <CimInstance>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-ResourceUri <Uri>]
-CimSession <CimSession[]>
[-KeyOnly]
[<CommonParameters>] Description
Get-CimAssociatedInstance cmdlet은 연결에 의해 원본 인스턴스라고 하는 특정 CIM 인스턴스에 연결된 CIM 인스턴스를 검색합니다.
연결에서 각 CIM 인스턴스에는 명명된 역할이 있으며 동일한 CIM 인스턴스가 서로 다른 역할의 연결에 참여할 수 있습니다.
InputObject 매개 변수를 지정하지 않은 경우 cmdlet은 다음 방법 중 하나로 작동합니다.
- ComputerName 매개 변수와 CimSession 매개 변수가 모두 지정되지 않은 경우 이 cmdlet은 COM(구성 요소 개체 모델) 세션을 사용하여 로컬 WMI(Windows Management Instrumentation)에서 작동합니다.
- ComputerName 매개 변수 또는 CimSession 매개 변수가 지정된 경우 이 cmdlet은 ComputerName 매개 변수 또는 CimSession 매개 변수로 지정된 CIM 서버에 대해 작동합니다.
예제
예제 1: 특정 인스턴스의 연결된 모든 인스턴스 가져오기
PS C:\>$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
PS C:\>Get-CimAssociatedInstance -InputObject $disk[1]이 명령 집합은 Win32_LogicalDisk 클래스의 인스턴스를 검색하고 Get-CimInstance cmdlet을 사용하여 $disk 변수에 정보를 저장합니다. 변수의 첫 번째 논리 디스크 인스턴스는 지정된 CIM 인스턴스의 연결된 모든 CIM 인스턴스를 가져오기 위해 Get-CimAssociatedInstance cmdlet의 입력 개체로 사용됩니다.
예제 2: 특정 형식의 연결된 모든 인스턴스 가져오기
PS C:\>$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
PS C:\>Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition이 명령 집합은 Win32_LogicalDisk 클래스의 모든 인스턴스를 검색하고 $disk 변수에 저장합니다. 변수의 첫 번째 논리 디스크 인스턴스는 지정된 연결 클래스 Win32_DiskPartition 통해 연결된 모든 연결된 인스턴스를 가져오기 위해 Get-CimAssociatedInstance cmdlet의 입력 개체로 사용됩니다.
예제 3: 특정 클래스의 한정자를 통해 연결된 모든 인스턴스 가져오기
PS C:\>$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
PS C:\>Get-CimClass -ClassName *Service* -Qualifier "Association"
PS C:\>$c.CimClasName
Win32_LoadOrderGroupServiceDependencies
Win32_DependentService
Win32_SystemServices
Win32_LoadOrderGroupServiceMembers
Win32_ServiceSpecificationService
PS C:\>Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService이 명령 집합은 WMI(Windows Management Instrumentation) 서비스에 의존하는 서비스를 검색하고 $s 변수에 저장합니다. Win32_DependentService 연결 클래스 이름은 한정자로 연결을 지정하여 Get-CimClass cmdlet을 사용하여 검색한 다음 Get-CimAssociatedInstance cmdlet에 $s 전달하여 검색된 연결 클래스의 연결된 모든 인스턴스를 가져옵니다.
매개 변수
-Association
연결 클래스의 이름을 지정합니다.
이 매개 변수를 지정하지 않으면 cmdlet은 해당 형식에 관계없이 모든 기존 연결 개체를 반환합니다.
예를 들어 클래스 A가 두 개의 연결(AB1 및 AB2)을 통해 클래스 B와 연결된 경우 이 매개 변수를 사용하여 AB1 또는 AB2 연결 형식을 지정할 수 있습니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-CimSession
지정된 CIM 세션을 사용하여 명령을 실행합니다. CIM 세션이 포함된 변수 또는 CIM 세션을 만들거나 가져오는 명령(예: New-CimSession 또는 Get-CimSession)을 입력합니다. 자세한 내용은 about_CimSessions 참조하세요.
| 형식: | CimSession[] |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ComputerName
CIM 작업을 실행할 컴퓨터의 이름을 지정합니다. FQDN(정규화된 도메인 이름) 또는 NetBIOS 이름을 지정할 수 있습니다.
이 매개 변수를 지정하는 경우 cmdlet은 WsMan 프로토콜을 사용하여 지정된 컴퓨터에 임시 세션을 만듭니다.
이 매개 변수를 지정하지 않으면 cmdlet은 COM(구성 요소 개체 모델)을 사용하여 로컬 컴퓨터에서 작업을 수행합니다.
동일한 컴퓨터에서 여러 작업을 수행하는 경우 CIM 세션을 사용하여 연결하면 성능이 향상됩니다.
| 형식: | String[] |
| 별칭: | CN, ServerName |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
이 cmdlet에 대한 입력을 지정합니다. 이 매개 변수를 사용하거나 입력을 이 cmdlet으로 파이프할 수 있습니다.
| 형식: | CimInstance |
| 별칭: | CimInstance |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-KeyOnly
키 속성만 채워진 개체를 반환합니다.
이렇게 하면 네트워크를 통해 전송되는 데이터의 양이 줄어듭니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Namespace
CIM 작업의 네임스페이스를 지정합니다.
기본 네임스페이스는 root/cimv2입니다.
메모
Windows PowerShell은 로컬 WMI 서버에서 네임스페이스 목록을 가져오고 네임스페이스 목록을 제공하기 때문에 탭 완성을 사용하여 네임스페이스 목록을 찾아볼 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-OperationTimeoutSec
cmdlet이 컴퓨터의 응답을 기다리는 시간을 지정합니다.
기본적으로 이 매개 변수의 값은 0입니다. 즉, cmdlet은 서버에 대한 기본 시간 제한 값을 사용합니다.
OperationTimeoutSec 매개 변수가 3분의 강력한 연결 재시도 시간 제한보다 작은 값으로 설정된 경우 클라이언트가 다시 연결하기 전에 서버의 작업이 시간 초과되므로 OperationTimeoutSec 매개 변수 값보다 더 많이 지속되는 네트워크 오류는 복구할 수 없습니다.
| 형식: | UInt32 |
| 별칭: | OT |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ResourceUri
리소스 클래스 또는 인스턴스의 리소스 URI(Uniform Resource Identifier)를 지정합니다. URI는 컴퓨터에서 디스크 또는 프로세스와 같은 특정 유형의 리소스를 식별하는 데 사용됩니다.
URI는 접두사 및 리소스 경로로 구성됩니다. 예를 들어:
https://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 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ResultClassName
연결된 인스턴스의 클래스 이름을 지정합니다. CIM 인스턴스는 하나 이상의 CIM 인스턴스와 연결할 수 있습니다. 결과 클래스 이름을 지정하지 않으면 연결된 모든 CIM 인스턴스가 반환됩니다.
기본적으로 이 매개 변수의 값은 null이므로 연결된 모든 CIM 인스턴스가 반환됩니다.
특정 클래스 이름과 일치하도록 연결 결과를 필터링할 수 있습니다. 필터링은 서버에서 발생합니다. 이 매개 변수를 지정하지 않으면 Get-CIMAssociatedInstance 모든 기존 연결을 반환합니다. 예를 들어 클래스 A가 클래스 B, C 및 D와 연결된 경우 이 매개 변수를 사용하여 출력을 특정 형식(B, C 또는 D)으로 제한할 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
이 cmdlet은 입력 개체를 허용하지 않습니다.
출력
이 cmdlet은 개체를 반환합니다.