다음을 통해 공유

Get-CimClass

  • 참조
모듈:
CimCmdlets

특정 네임스페이스의 CIM 클래스 목록을 가져옵니다.

구문

Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-ComputerName <string[]>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]
Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   -CimSession <CimSession[]>
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]

Description

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

cmdlet은 Get-CimClass 특정 네임스페이스의 CIM 클래스 목록을 검색합니다. 제공된 클래스 이름이 없으면 cmdlet은 네임스페이스의 모든 클래스를 반환합니다. CIM 인스턴스와 달리 CIM 클래스는 검색되는 CIM 세션 또는 컴퓨터 이름을 포함하지 않습니다.

예제

예제 1: 모든 클래스 정의 가져오기

이 예제에서는 네임스페이스 루트/cimv2 아래에 있는 모든 클래스 정의를 가져옵니다.

Get-CimClass

예제 2: 특정 이름의 클래스 가져오기

이 예제에서는 이름에 디스크라는 단어가 포함된 클래스를 가져옵니다.

Get-CimClass -ClassName *disk*

예제 3: 특정 메서드 이름을 가진 클래스 가져오기

이 예제에서는 Win32 이름으로 시작하고 Term으로 시작하는 메서드 이름을 갖는 클래스를 가져옵니다.

Get-CimClass -ClassName Win32* -MethodName Term*

예제 4: 특정 속성 이름을 가진 클래스 가져오기

이 예제에서는 Win32 이름으로 시작하고 Handle 속성이 있는 클래스를 가져옵니다.

Get-CimClass -ClassName Win32* -PropertyName Handle

예제 5: 특정 한정자 이름을 가진 클래스 가져오기

다음은 Win32라는 이름으로 시작하는 클래스를 가져오고 이름에 Disk라는 단어를 포함하고 지정된 한정자 연결을 갖는 클래스를 가져오는 예제입니다.

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

예제 6: 특정 네임스페이스에서 클래스 정의 가져오기

이 예제에서는 지정된 네임스페이스 루트/standardCimv2에서 이름에 Net이라는 단어가 포함된 클래스 정의를 가져옵니다.

Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*

예제 7: 원격 서버에서 클래스 정의 가져오기

이 예제에서는 지정된 원격 서버 Server01 및 Server02에서 이름에 디스크라는 단어가 포함된 클래스 정의를 가져옵니다.

Get-CimClass -ClassName *disk* -ComputerName Server01, Server02

예제 8: CIM 세션을 사용하여 클래스 가져오기

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *disk* -CimSession $s

이 명령 집합은 여러 컴퓨터가 있는 세션을 만들고 cmdlet을 사용하여 New-CimSession 변수 $s 에 저장한 다음 cmdlet을 사용하여 클래스를 Get-CimClass 가져옵니다.

매개 변수

-Amended

CIM 쿼리에서 반환된 개체에 수정된 정보가 포함되어야 임을 나타냅니다. 일반적으로 수정된 정보는 CIM 개체에 연결된 개체 및 속성 설명과 같은 지역화 가능한 정보입니다. 이는 숫자 값을 사람이 읽을 수 있는 값으로 변환하는 데 유용합니다.

이 매개 변수는 PowerShell 7.3에 추가되었습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CimSession

원격 세션 또는 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름 또는 세션 개체(예: a 또는 Get-CimSession cmdlet의 출력)를 New-CimSession 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.

형식:CimSession[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ClassName

작업을 수행할 CIM 클래스의 이름을 지정합니다. PowerShell은 클래스 이름 목록을 제공하기 위해 로컬 WMI 서버에서 클래스 목록을 가져오므로 탭 완성을 사용하여 클래스 목록을 찾아볼 수 있습니다.

형식:String
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-ComputerName

CIM 작업을 실행할 컴퓨터를 지정합니다. FQDN(정규화된 도메인 이름)을 NetBIOS 이름 또는 IP 주소를 지정할 수 있습니다.

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

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

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

형식:String[]
별칭:CN, ServerName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MethodName

이 이름과 일치하는 메서드가 있는 클래스를 찾습니다. 이 매개 변수와 함께 와일드카드 문자를 사용할 수 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-Namespace

CIM 작업의 네임스페이스를 지정합니다. 기본 네임스페이스는 root/cimv2입니다. PowerShell은 네임스페이스 목록을 제공하기 위해 로컬 WMI 서버에서 네임스페이스 목록을 가져오므로 탭 완성을 사용하여 네임스페이스 목록을 찾아볼 수 있습니다.

형식:String
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-OperationTimeoutSec

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

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

형식:UInt32
별칭:OT
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PropertyName

이 이름과 일치하는 속성이 있는 클래스를 찾습니다. 이 매개 변수와 함께 와일드카드 문자를 사용할 수 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-QualifierName

클래스 수준 한정자 이름을 사용하여 클래스를 필터링합니다. 이 매개 변수와 함께 와일드카드 문자를 사용할 수 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

입력

None

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

출력

CimClass

이 cmdlet은 CIM 클래스 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Get-CimClass

  • Windows:
    • gcls

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