다음을 통해 공유

Get-CimAssociatedInstance

  • 참조
모듈:
CimCmdlets

연결에 의해 특정 CIM 인스턴스에 연결된 CIM 인스턴스를 검색합니다.

Syntax

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

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

cmdlet은 Get-CimAssociatedInstance 연결에 의해 원본 인스턴스라고 하는 특정 CIM 인스턴스에 연결된 CIM 인스턴스를 검색합니다.

연결에서 각 CIM 인스턴스에는 명명된 역할이 있으며 동일한 CIM 인스턴스가 서로 다른 역할의 연결에 참여할 수 있습니다.

InputObject 매개 변수를 지정하지 않은 경우 cmdlet은 다음 방법 중 하나로 작동합니다.

  • ComputerName 매개 변수와 CimSession 매개 변수가 모두 지정되지 않은 경우 이 cmdlet은 COM(구성 요소 개체 모델) 세션을 사용하여 로컬 WMI(Windows Management Instrumentation)에서 작동합니다.
  • ComputerName 매개 변수 또는 CimSession 매개 변수가 지정된 경우 이 cmdlet은 ComputerName 매개 변수 또는 CimSession 매개 변수로 지정된 CIM 서버에 대해 작동합니다.

예제

예제 1: 특정 인스턴스의 연결된 모든 인스턴스 가져오기

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

이 명령 집합은 Win32_LogicalDisk 클래스의 인스턴스를 검색하고 cmdlet을 사용하여 명명 $disk 된 변수에 Get-CimInstance 정보를 저장합니다. 변수의 첫 번째 논리 디스크 인스턴스는 지정된 CIM 인스턴스의 연결된 모든 CIM 인스턴스를 가져오기 위해 Get-CimAssociatedInstance cmdlet의 입력 개체로 사용됩니다.

예제 2: 특정 형식의 연결된 모든 인스턴스 가져오기

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

이 명령 집합은 Win32_LogicalDisk 클래스의 모든 인스턴스를 검색하고 명명$disk된 변수에 저장합니다. 변수의 첫 번째 논리 디스크 인스턴스는 지정된 연결 클래스 Win32_DiskPartition 통해 연결된 모든 연결된 인스턴스를 가져오기 위해 Get-CimAssociatedInstance cmdlet의 입력 개체로 사용됩니다.

예제 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된 변수에 저장합니다. Win32_DependentService 연결 클래스 이름은 한정자로 연결을 지정하여 cmdlet을 사용하여 Get-CimClass 검색된 다음, 검색된 연결 클래스의 연결된 모든 인스턴스를 가져오기 위해 Get-CimAssociatedInstance cmdlet에 $s 전달됩니다.

매개 변수

-Association

연결 클래스의 이름을 지정합니다. 이 매개 변수를 지정하지 않으면 cmdlet은 모든 형식의 모든 기존 연결 개체를 반환합니다.

예를 들어 클래스 A가 두 개의 연결(AB1 및 AB2)을 통해 클래스 B와 연결된 경우 이 매개 변수를 사용하여 AB1 또는 AB2 연결 형식을 지정할 수 있습니다.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CimSession

지정된 CIM 세션을 사용하여 명령을 실행합니다. CIM 세션이 포함된 변수를 입력하거나 CIM 세션을 만들거나 가져오는 명령(예: New-CimSession Get-CimSession>)을 입력합니다. 자세한 내용은 about_CimSession 참조하세요.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

CIM 작업을 실행할 컴퓨터의 이름을 지정합니다. FQDN(정규화된 do기본 이름) 또는 NetBIOS 이름을 지정할 수 있습니다.

이 매개 변수를 지정하는 경우 cmdlet은 WsMan 프로토콜을 사용하여 지정된 컴퓨터에 임시 세션을 만듭니다.

이 매개 변수를 지정하지 않으면 cmdlet은 COM(구성 요소 개체 모델)을 사용하여 로컬 컴퓨터에서 작업을 수행합니다.

동일한 컴퓨터에서 여러 작업을 수행하는 경우 CIM 세션을 사용하여 연결하면 성능이 향상됩니다.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

이 cmdlet에 대한 입력을 지정합니다. 이 매개 변수를 사용하거나 입력을 이 cmdlet으로 파이프할 수 있습니다.

InputObject 매개 변수는 컬렉션에 대해 열거되지 않습니다. 컬렉션이 전달되면 오류가 throw됩니다. 컬렉션을 사용할 때 입력을 파이프하여 값을 열거합니다.

Type:CimInstance
Aliases:CimInstance
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyOnly

키 속성만 채워진 개체를 반환합니다. 이렇게 하면 네트워크를 통해 전송되는 데이터의 양이 줄어듭니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

CIM 작업의 네임스페이스를 지정합니다. 기본 네임스페이스는 root/cimv2입니다.

참고 항목

PowerShell은 네임스페이스 목록을 제공하기 위해 로컬 WMI 서버에서 네임스페이스 목록을 가져오므로 탭 완성을 사용하여 네임스페이스 목록을 찾아볼 수 있습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

cmdlet이 컴퓨터의 응답을 기다리는 시간을 지정합니다. 기본적으로 이 매개 변수의 값은 0입니다. 즉, cmdlet은 서버에 대한 기본 시간 제한 값을 사용합니다.

OperationTimeoutSec 매개 변수가 3분의 강력한 연결 재시도 시간 제한보다 작은 값으로 설정된 경우 클라이언트가 다시 연결하기 전에 서버의 작업이 시간 초과되므로 OperationTimeoutSec 매개 변수 값보다 더 많이 지속되는 네트워크 오류는 복구할 수 없습니다.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceUri

리소스 클래스 또는 인스턴스의 리소스 URI(Uniform Resource Identifier)를 지정합니다. 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 매개 변수가 무시됩니다.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResultClassName

연결된 인스턴스의 클래스 이름을 지정합니다. CIM 인스턴스는 하나 이상의 CIM 인스턴스와 연결할 수 있습니다. 결과 클래스 이름을 지정하지 않으면 연결된 모든 CIM 인스턴스가 반환됩니다.

기본적으로 이 매개 변수의 값은 null이며 연결된 모든 CIM 인스턴스가 반환됩니다.

특정 클래스 이름과 일치하도록 연결 결과를 필터링할 수 있습니다. 필터링은 서버에서 발생합니다. 이 매개 변수를 Get-CIMAssociatedInstance 지정하지 않으면 모든 기존 연결을 반환합니다. 예를 들어 클래스 A가 클래스 B, C 및 D와 연결된 경우 이 매개 변수를 사용하여 출력을 특정 형식(B, C 또는 D)으로 제한할 수 있습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

CimInstance

이 cmdlet은 CIM 인스턴스 개체를 반환합니다.

참고

PowerShell에는 ''에 대한 다음 별칭이 포함되어 있습니다.

  • Windows:
    • gcai

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.