다음을 통해 공유

Invoke-DscResource

모듈:
PSDesiredStateConfiguration Module

지정된 PowerShell DSC(필요한 상태 구성) 리소스의 메서드를 실행합니다.

구문

Default (기본값) 

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

Description

Invoke-DscResource cmdlet은 지정된 PowerShell DSC(필요한 상태 구성) 리소스의 메서드를 실행합니다.

이 cmdlet은 구성 문서를 만들지 않고 DSC 리소스를 직접 호출합니다. 구성 관리 제품은 이 cmdlet을 사용하여 DSC 리소스를 사용하여 Windows 또는 Linux를 관리할 수 있습니다.

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

예제

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

이 예제에서는 WindowsProcess 리소스의 Set 메서드를 호출하고 필수 경로 및 인수 속성을 제공하여 지정된 Windows 프로세스를 시작합니다.

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

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

이 예제에서는 PSDesiredStateConfiguration모듈에 있는 WindowsProcess리소스의 Test 메서드를 호출합니다.

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

Invoke-DscResource @SplatParam

매개 변수

-Method

이 cmdlet이 호출하는 리소스의 메서드를 지정합니다. 이 매개 변수에 허용되는 값은 가져오기, 설정 및 테스트 .

매개 변수 속성

형식:String
Default value:None
허용되는 값:Get, Set, Test
와일드카드 지원:False
DontShow:False

매개 변수 집합

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

-ModuleName

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

매개 변수 속성

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

매개 변수 집합

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

-Name

호출할 DSC 리소스의 이름을 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-Property

해시 테이블의 리소스 속성 이름과 해당 값을 각각 키와 값으로 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

CommonParameters

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

입력

String

ModuleSpecification

출력

Object

참고

  • PsDscRunAsCredential 키를 사용하여 사용자 컨텍스트로 지정하지 않는 한 Windows PowerShell 5.1 리소스는 시스템 컨텍스트에서 실행되었습니다. PowerShell 7.0에서는 리소스가 사용자의 컨텍스트에서 실행되고 PsDscRunAsCredential 더 이상 지원되지 않습니다. 이 키를 사용하면 cmdlet이 예외를 throw합니다.

  • PowerShell 7을 기준으로 Invoke-DscResource 더 이상 WMI DSC 리소스 호출을 지원하지 않습니다. 여기에는 PSDesiredStateConfiguration파일 및 로그 리소스가 포함됩니다.