Invoke-CimMethod

모듈:

CimCmdlets Module

CIM 클래스의 메서드를 호출합니다.

구문

ClassNameComputerSet (기본값)

Invoke-CimMethod
    [-ClassName] <String>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClassNameSessionSet

Invoke-CimMethod
    [-ClassName] <String>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -CimSession <CimSession[]>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriComputerSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -ResourceUri <Uri>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimInstanceSessionSet

Invoke-CimMethod
    [-InputObject] <CimInstance>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimInstanceComputerSet

Invoke-CimMethod
    [-InputObject] <CimInstance>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriSessionSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -ResourceUri <Uri>
    -CimSession <CimSession[]>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassComputerSet

Invoke-CimMethod
    [-CimClass] <CimClass>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassSessionSet

Invoke-CimMethod
    [-CimClass] <CimClass>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -CimSession <CimSession[]>
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QueryComputerSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -Query <String>
    [-QueryDialect <String>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QuerySessionSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -Query <String>
    -CimSession <CimSession[]>
    [-QueryDialect <String>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Invoke-CimMethod cmdlet은 Arguments 매개 변수로 지정된 이름-값 쌍을 사용하여 CIM 클래스 또는 CIM 인스턴스의 메서드를 호출합니다.

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

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

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

• ComputerName 매개 변수나 CimSession 매개 변수가 지정되지 않은 경우 이 cmdlet은 입력 개체의 CIM 세션 또는 컴퓨터 이름을 사용합니다.
• ComputerName 매개 변수 또는 CimSession 매개 변수가 지정된 경우, 이 cmdlet은 CimSession 매개 변수 값 또는 ComputernName 매개 변수 값을 사용합니다. 일반적인 시나리오는 아닙니다.

예제

예제 1: 메서드 호출

이 예제에서는 Win32_Process 클래스의 Terminate 메서드를 호출합니다.

Invoke-CimMethod -Query 'select * from Win32_Process where name like "notepad%"' -MethodName "Terminate"

예제 2: CIM 인스턴스 개체를 사용하여 메서드 호출

이 예제에서는 CIM 인스턴스 개체를 검색하고 $x cmdlet을 사용하여 Get-CimInstance 변수에 저장합니다. 그런 다음 변수의 내용은 InputObject로 Invoke-CimMethod cmdlet에 사용됩니다. CimInstance에 대해 GetOwner 메서드가 호출됩니다.

$x = Get-CimInstance -Query 'Select * from Win32_Process where name like "notepad%"'
Invoke-CimMethod -InputObject $x -MethodName GetOwner

예제 3: 인수를 사용하여 정적 메서드 호출

이 예제에서는 Arguments 매개 변수를 사용하여 명명된 Create 메서드를 호출합니다.

Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{
  CommandLine = 'notepad.exe'; CurrentDirectory = "C:\windows\system32"
}

예제 4: 클라이언트 쪽 유효성 검사

이 예제에서는 CimClass 개체를 전달하여 Invoke-CimMethod 메서드에 대한 클라이언트 쪽 유효성 검사를 수행합니다.

$c = Get-CimClass -ClassName Win32_Process
Invoke-CimMethod -CimClass $c -MethodName "xyz" -Arguments @{ CommandLine = 'notepad.exe' }

매개 변수

-Arguments

호출된 메서드에 전달할 매개 변수를 지정합니다. 이 매개 변수의 값을 해시 테이블에 저장된 이름-값 쌍으로 지정합니다. 입력한 값의 순서는 중요하지 않습니다.

매개 변수 속성

형식:	IDictionary
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	1
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-CimClass

서버에서 CIM 클래스 정의를 나타내는 CIM 클래스 개체를 지정합니다. 클래스의 정적 메서드를 호출할 때 이 매개 변수를 사용합니다.

Get-CimClass cmdlet을 사용하여 서버에서 클래스 정의를 검색할 수 있습니다.

이 매개 변수를 사용하면 클라이언트 쪽 스키마 유효성 검사가 향상됩니다.

매개 변수 속성

형식:	CimClass
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

CimClassComputerSet

Position:	0
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CimClassSessionSet

Position:	0
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CimSession

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

매개 변수 속성

형식:	CimSession[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ClassNameSessionSet

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CimInstanceSessionSet

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CimClassSessionSet

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

QuerySessionSet

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ResourceUriSessionSet

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ClassName

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	클래스

매개 변수 집합

ClassNameComputerSet

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

ClassNameSessionSet

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ComputerName

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

이 매개 변수를 사용하는 경우 cmdlet은 WsMan 프로토콜을 사용하여 지정된 컴퓨터에 임시 세션을 만듭니다. 그렇지 않으면 cmdlet은 COM(구성 요소 개체 모델)을 사용하여 로컬 컴퓨터에서 작업을 수행합니다.

동일한 컴퓨터에서 여러 작업을 수행할 때 성능을 향상시키려면 CIM 세션을 사용하여 연결합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	중국, 서버 이름

매개 변수 집합

ClassNameComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

ResourceUriComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

CimClassComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

CimInstanceComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

QueryComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InputObject

메서드를 호출하기 위한 입력으로 사용할 CIM 인스턴스 개체를 지정합니다. 이 매개 변수는 인스턴스 메서드를 호출하는 데만 사용할 수 있습니다. 클래스 정적 메서드를 호출하려면 클래스 매개 변수 또는 CimClass 매개 변수를 사용합니다.

매개 변수 속성

형식:	CimInstance
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	CimInstance

매개 변수 집합

CimInstanceComputerSet

Position:	0
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CimInstanceSessionSet

Position:	0
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MethodName

호출할 CIM 메서드의 이름을 지정합니다. 이 매개 변수는 필수이며 null이거나 비워 둘 수 없습니다. CIM 클래스의 정적 메서드를 호출하려면 ClassName 또는 CimClass 매개 변수를 사용합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	이름

매개 변수 집합

(All)

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Namespace

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ClassNameComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

ClassNameSessionSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

ResourceUriComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

ResourceUriSessionSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

QuerySessionSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

QueryComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-OperationTimeoutSec

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

OperationTimeoutSec 매개 변수가 기본 연결 재시도 시간 제한인 3분보다 작은 값으로 설정된 경우 OperationTimeoutSec 매개 변수의 값보다 더 많은 네트워크 오류를 복구할 수 없습니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	오티

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Query

CIM 서버에서 실행할 쿼리를 지정합니다. 쿼리의 결과로 수신된 인스턴스에서 메서드가 호출됩니다. QueryDialect 매개 변수를 사용하여 쿼리 방언을 지정할 수 있습니다.

지정된 값에 큰따옴표("), 작은따옴표(') 또는 백슬래시(\)가 포함된 경우, 해당 문자 앞에 백슬래시(\)를 붙여서 이스케이프해야 합니다. 지정된 값이 WQL LIKE 연산자를 사용하는 경우 대괄호([]): 백분율(%), 밑줄(_) 또는 여는 대괄호([)로 묶어 다음 문자를 이스케이프해야 합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

QuerySessionSet

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

QueryComputerSet

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-QueryDialect

쿼리 매개 변수에 사용되는 쿼리 언어를 지정합니다. 이 매개 변수에 허용되는 값은 WQL 또는 CQL.

기본값은 WQL입니다.

매개 변수 속성

형식:	String
Default value:	WQL
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

QuerySessionSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

QueryComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	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 매개 변수가 무시됩니다.

매개 변수 속성

형식:	Uri
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

CimInstanceComputerSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

CimInstanceSessionSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

CimClass

CIM 클래스를 이 cmdlet으로 파이프할 수 있습니다.

CimInstance

CIM 인스턴스를 이 cmdlet으로 파이프할 수 있습니다.

출력

PSCustomObject

이 cmdlet은 개체를 반환합니다.

참고

PowerShell에는 Invoke-CimMethod에 대한 다음과 같은 별칭들이 포함되어 있습니다.

• Windows:
  • icim

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

관련 링크

• Get-CimClass
• Get-CimInstance
• Get-CimSession (CIM 세션 가져오기)
• 새로운 Cim 세션