다음을 통해 공유

Invoke-DscResource

  • 참조
모듈:
PSDesiredStateConfiguration

지정된 DSC 리소스의 메서드를 실행합니다.

구문

Invoke-DscResource
      [-Name] <String>
      [-Method] <String>
      -ModuleName <ModuleSpecification>
      -Property <Hashtable>
      [<CommonParameters>]

Description

Invoke-DscResource cmdlet은 지정된 Windows PowerShell DSC(필요한 상태 구성) 리소스의 메서드를 실행합니다. 이 cmdlet을 실행하기 전에 LCM(로컬 구성 관리자)의 새로 고침 모드를 사용 안 함으로 설정합니다.

이 cmdlet은 구성 문서를 만들지 않고 DSC 리소스를 직접 호출합니다. 구성 관리 제품은 이 cmdlet을 사용하여 DSC 리소스를 사용하여 창을 관리할 수 있습니다. 또한 이 cmdlet을 사용하면 DSC 엔진 또는 LCM이 디버깅을 사용하도록 설정된 상태로 실행될 때 리소스를 디버깅할 수 있습니다.

이 cmdlet은 복합 리소스에서 작동하지 않습니다. 복합 리소스는 매개 변수가 있는 구성입니다. 복합 리소스를 사용하려면 LCM이 필요합니다.

예제

예제 1: 필수 속성을 지정하여 리소스의 Set 메서드 호출

Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration

이 명령은 Log라는 리소스의 Set 메서드를 호출하고 Message 속성을 지정합니다.

예제 2: 지정된 모듈에 대한 리소스의 테스트 메서드 호출

Invoke-DscResource -Name WindowsProcess -Method Test -Property @{Path = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'; Arguments = ''} -ModuleName PSDesiredStateConfiguration

이 명령은 PSDesiredStateConfiguration이라는 모듈에 있는 WindowsProcess라는 리소스의 Test 메서드를 호출합니다.

매개 변수

-Method

이 cmdlet이 호출하는 리소스의 메서드를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Get
  • Set
  • Test
형식:String
허용되는 값:Get, Set, Test
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ModuleName

이 cmdlet이 지정된 리소스를 호출하는 모듈의 이름을 지정합니다.

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

-Name

시작할 DSC 리소스의 이름을 지정합니다.

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

-Property

해시 테이블의 리소스 속성 이름과 해당 값을 각각 키와 값으로 지정합니다. Get-DscResource cmdlet을 사용하여 리소스 속성 및 해당 형식을 검색합니다.

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

출력

Microsoft.Management.Infrastructure.CimInstance, System.Boolean