DSC 리소스와 함께 자격 증명 사용

적용 대상: Windows PowerShell 5.0, Windows PowerShell 5.1

구성에서 자동 PsDscRunAsCredential 속성을 사용하여 지정된 자격 증명 집합으로 DSC 리소스를 실행할 수 있습니다. 기본적으로 DSC는 각 리소스를 시스템 계정으로 실행합니다. 하지만 특정 사용자 컨텍스트에서 MSI 패키지 설치, 사용자 레지스트리 키 설정, 사용자의 특정 로컬 디렉터리 액세스, 또는 네트워크 공유에 액세스와 같이 사용자로 실행이 필요한 경우도 있습니다. PSDSCRunAssential에 지정한 모든 계정에 대해 대상 머신에서 SeInteractiveLogonRight이 필요합니다. 자세한 내용은 계정 권한 상수를 참조하세요.

각 DSC 리소스에는 사용자 자격 증명(PSCredential 개체)으로 설정할 수 있는 PsDscRunAsCredential 속성이 있습니다. 자격 증명을 구성에서 속성 값으로 하드 코드하거나 값을 Get-Credential로 설정할 수 있습니다. 후자의 경우 구성을 컴파일할 때 자격 증명을 지정하라는 메시지가 표시됩니다(구성 컴파일에 대해서는 구성 참조).

참고

PowerShell 5.0에서는 복합 리소스를 호출하는 구성에 PsDscRunAsCredential 속성을 사용하는 기능은 지원되지 않았습니다. PowerShell 5.1에서는 복합 리소스를 호출하는 구성에 PsDscRunAsCredential 속성이 지원됩니다. PowerShell 4.0에서는 PsDscRunAsCredential 속성을 사용할 수 없습니다.

다음 예제에서는 Get-Credential을 사용하여 사용자에게 자격 증명을 지정하라는 메시지를 표시합니다. Registry 리소스는 Windows 명령 프롬프트 창의 배경색을 지정하는 레지스트리 키를 변경하는 데 사용됩니다.

Configuration ChangeCmdBackGroundColor
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node $AllNodes.NodeName
    {
        Registry CmdPath
        {
            Key                  = 'HKEY_CURRENT_USER\SOFTWARE\Microsoft\Command Processor'
            ValueName            = 'DefaultColor'
            ValueData            = '1F'
            ValueType            = 'DWORD'
            Ensure               = 'Present'
            Force                = $true
            Hex                  = $true
            PsDscRunAsCredential = Get-Credential
        }
    }
}

$configData = @{
    AllNodes = @(
        @{
            NodeName             = 'localhost';
            PSDscAllowDomainUser = $true
            CertificateFile      = 'C:\publicKeys\targetNode.cer'
            Thumbprint           = '7ee7f09d-4be0-41aa-a47f-96b9e3bdec25'
        }
    )
}

ChangeCmdBackGroundColor -ConfigurationData $configData

참고

이 예제에서는 C:\publicKeys\targetNode.cer에 유효한 인증서가 있고 해당 인증서의 지문이 표시된 값이라고 가정합니다. DSC 구성 MOF 파일에서 자격 증명을 암호화 하는 방법에 대한 자세한 내용은 MOF 파일 보안을 참조하세요.