DSC(원하는 상태 구성)의 알려진 문제 및 제한 사항

아티클
11/08/2024

주요 변경 내용: DSC 구성에서 암호를 암호화/암호 해독하는 데 사용된 인증서가 WMF 5.0 RTM 설치 후 작동하지 않을 수 있음

WMF 4.0 및 WMF 5.0 Preview 릴리스의 DSC 구성에서는 121자보다 긴 암호를 허용하지 않았습니다. DSC는 길고 강력한 암호가 적합한 경우에도 짧은 암호를 사용해야 했습니다. 이 새로운 변경 사항은 DSC 구성에서 임의 길이의 암호를 허용합니다.

해결 방법: 데이터 암호화 또는 키 암호화 키 사용 및 문서 암호화 향상된 키 사용(1.3.6.1.4.1.311.80.1)을 사용하여 인증서를 다시 만드세요. 자세한 내용은 Protect-CmsMessage를 참조하세요.

DSC cmdlet이 WMF 5.0 RTM 설치 후 실패할 수 있음

WMF 5.0 RTM 설치 후 Start-DscConfiguration 및 기타 DSC cmdlet이 다음과 같은 오류로 인해 실패할 수 있습니다.

LCM failed to retrieve the property PendingJobStep from the object of class dscInternalCache .
+ CategoryInfo : ObjectNotFound: (root/Microsoft/...gurationManager:String) [], CimException
+ FullyQualifiedErrorId : MI RESULT 6
+ PSComputerName : localhost

해결 방법: 다음 명령을 관리자 권한 PowerShell 세션에서 실행(관리자 권한으로 실행)하여 DSCEngineCache.mof를 삭제하세요.

Remove-Item -Path $env:SystemRoot\system32\Configuration\DSCEngineCache.mof

WMF 5.0 RTM이 WMF 5.0 Production Preview 위에 설치된 경우 DSC cmdlet이 작동하지 않을 수 있음

해결 방법: 다음 명령을 관리자 권한 PowerShell 세션에서 실행(관리자 권한으로 실행)하세요.

mofcomp $env:windir\system32\wbem\DscCoreConfProv.mof

DebugMode에서 Get-DscConfiguration을 사용하는 동안 LCM이 불안정한 상태가 될 수 있음

LCM이 DebugMode인 경우 Ctrl+C를 눌러 Get-DscConfiguration의 처리를 중지하면 LCM이 불안정한 상태가 되어 대부분의 DSC cmdlet이 작동하지 않을 수 있습니다.

해결 방법:Get-DscConfiguration cmdlet을 디버깅하는 동안 Ctrl+C를 누르지 마세요.

Stop-DscConfiguration이 DebugMode에서 응답하지 않을 수 있습니다.

LCM이 DebugMode인 경우 Get-DscConfiguration으로 시작한 작업을 중지하려고 하면 Stop-DscConfiguration이 응답하지 않을 수 있습니다.

해결 방법:DSC 리소스 디버그에 설명된 대로 Get-DscConfiguration으로 시작한 작업의 디버깅을 완료하세요.

DebugMode에 자세한 오류 메시지가 표시되지 않음

LCM이 DebugMode인 경우 DSC 리소스에서 자세한 오류 메시지가 표시되지 않습니다.

해결 방법: 리소스에서 자세한 정보 메시지를 표시하려면 DebugMode를 사용하지 않도록 설정하세요.

Get-DscConfigurationStatus cmdlet에서 Invoke-DscResource 작업을 검색할 수 없음

Invoke-DscResource cmdlet을 사용하여 리소스의 메서드를 직접 호출한 후에는 Get-DscConfigurationStatus를 통해 이 작업의 레코드를 검색할 수 없습니다.

해결 방법: 없음

Get-DscConfigurationStatus에서 끌어오기 주기 작업을 Consistency 형식으로 반환함

노드가 PULL 새로 고침 모드로 설정된 경우 수행된 각 끌어오기 작업에 대해 Get-DscConfigurationStatus cmdlet은 작업 유형을 Initial이 아닌 Consistency로 보고합니다.

해결 방법: 없음

Invoke-DscResource cmdlet이 메시지를 생성된 순서대로 반환하지 않음

Invoke-DscResource cmdlet이 자세한 정보, 경고 및 오류 메시지를 LCM 또는 DSC 리소스에서 생성된 순서대로 반환하지 않습니다.

해결 방법: 없음

Invoke-DscResource와 함께 사용할 경우 DSC 리소스를 쉽게 디버그할 수 없음

LCM이 디버그 모드에서 실행되고 있으면 Invoke-DscResource cmdlet에서 디버깅을 위해 연결할 runspace에 대한 정보를 제공하지 않습니다. 자세한 내용은 DSC 리소스 디버그를 참조하세요.

해결 방법:Get-PSHostProcessInfo, Enter-PSHostProcess, Get-Runspace 및 Debug-Runspace cmdlet을 사용하여 runspace를 검색 및 연결하여 DSC 리소스를 디버깅하세요.

# Find all the processes hosting PowerShell
Get-PSHostProcessInfo

ProcessName    ProcessId AppDomainName
-----------    --------- -------------
powershell          3932 DefaultAppDomain
powershell_ise      2304 DefaultAppDomain
WmiPrvSE            3396 DscPsPluginWkr_AppDomain

# Enter the process that is hosting DSC engine (WMI process with DscPsPluginWkr_Appdomain)
Enter-PSHostProcess -Id 3396 -AppDomainName DscPsPluginWkr_AppDomain

# Find all the available rusnspaces in that process
Get-Runspace

Id Name       ComputerName Type  State  Availability
-- ----       ------------ ----  -----  ------------
 2 Runspace2  localhost    Local Opened InBreakpoint
 5 RemoteHost localhost    Local Opened Busy

# Debug the runspace that is in **InBreakpoint** availability state
Debug-Runspace -Id 2

동일한 노드에 대한 다양한 부분 구성 문서에 동일한 리소스 이름이 포함될 수 없음

단일 노드로 배포되는 여러 부분 구성에 대해 리소스 이름이 동일하면 런타임 오류가 발생합니다.

해결 방법: 다른 부분 구성에 있는 동일한 리소스인 경우에도 다른 이름을 사용하세요.

Start-DscConfiguration –UseExisting이 -Credential에서 작동하지 않음

Start-DscConfiguration을 UseExisting 매개 변수와 함께 사용하면 Credential 매개 변수가 무시됩니다. DSC에서는 기본 프로세스 ID를 사용하여 작업을 계속합니다. 그러면 원격 노드에서 계속 진행하는 데 다른 자격 증명이 필요하면 오류가 발생합니다.

해결 방법: 원격 DSC 작업에 CIM 세션을 사용하세요.

$session = New-CimSession -ComputerName $node -Credential $credential
Start-DscConfiguration -UseExisting -CimSession $session

DSC 구성에서 노드 이름으로 사용된 IPv6 주소

이 릴리스에서는 DSC 구성 스크립트에서 노드 이름으로 사용되는 IPv6 주소가 지원되지 않습니다.

해결 방법: 없음

`Class-Based` DSC 리소스의 디버깅

이 릴리스에서는 클래스 기반 DSC 리소스의 디버깅이 지원되지 않습니다.

해결 방법: 없음

DSC 클래스 기반 리소스의 $script 범위에 정의된 변수 및 함수는 여러 DSC 리소스 호출에서 유지되지 않습니다.

구성에서 $script 범위에 정의된 변수나 함수가 있는 클래스 기반 리소스를 사용하고 있는 경우 Start-DSCConfiguration을 여러 번 연속해서 호출할 수 없습니다.

해결 방법: DSC 리소스 클래스 자체에서 모든 변수 및 함수를 정의하세요. $script 범위 변수/함수가 없습니다.

리소스가 PSDscRunAsCredential을 사용하는 경우의 DSC 리소스 디버깅

이 릴리스에서는 리소스가 구성에서 PSDscRunAsCredential 속성을 사용하는 경우의 DSC 리소스 디버깅이 지원되지 않습니다.

해결 방법: 없음

DSC 복합 리소스에서는 PsDscRunAsCredential이 지원되지 않음

해결 방법: 사용 가능한 경우 Credential 속성을 사용하세요. 예제 ServiceSet 및 WindowsFeatureSet

Get-DscResource -Syntax에 PsDscRunAsCredential이 올바르게 반영되지 않음

리소스에서 필수로 표시하거나 지원하지 않는 경우 Syntax 매개 변수는 PsDscRunAsCredential을 올바르게 반영하지 않습니다.

해결 방법: 없음 그러나 ISE에서 구성을 작성하면 IntelliSense를 사용할 때 PsDscRunAsCredential 속성에 대한 올바른 메타데이터가 반영됩니다.

WindowsOptionalFeature를 Windows 7에서 사용할 수 없음

WindowsOptionalFeature DSC 리소스는 Windows 7에서 사용할 수 없습니다. 이 리소스에는 DISM 모듈 및 Windows 운영 체제의 Windows 8 이상 버전부터 사용할 수 있는 DISM cmdlet이 필요합니다.

클래스 기반 DSC 리소스의 경우, Import-DscResource -ModuleVersion이 예상대로 작동하지 않을 수 있습니다.

컴파일 노드에 여러 버전의 클래스 기반 DSC 리소스 모듈이 있는 경우 Import-DscResource -ModuleVersion은 지정된 버전을 선택하지 않고 다음 컴파일 오류가 발생합니다.

ImportClassResourcesFromModule : Exception calling "ImportClassResourcesFromModule" with "3" argument(s):
 "Keyword 'MyTestResource' already defined in the configuration."
At C:\Windows\system32\WindowsPowerShell\v1.0\Modules\PSDesiredStateConfiguration\PSDesiredStateConfiguration.psm1:2035 char:35
+ ... rcesFound = ImportClassResourcesFromModule -Module $mod -Resources $r ...
+                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [ImportClassResourcesFromModule], MethodInvocationException
    + FullyQualifiedErrorId : PSInvalidOperationException,ImportClassResourcesFromModule

해결 방법: 다음과 같이 ModuleSpecification 개체를 RequiredVersion 키가 지정된 ModuleName 매개 변수로 정의하여 필요한 버전을 가져오세요.

Import-DscResource -ModuleName @{ModuleName='MyModuleName';RequiredVersion='1.2'}

레지스트리 리소스와 같은 일부 DSC 리소스는 요청을 처리하는 데 시간이 오래 걸릴 수 있습니다.

해결 방법 1: 다음 폴더를 정기적으로 정리하는 일정 작업을 만듭니다.

$env:windir\system32\config\systemprofile\AppData\Local\Microsoft\Windows\PowerShell\CommandAnalysis

해결 방법 2: 구성 마지막에 CommandAnalysis 폴더를 정리하도록 DSC 구성을 변경합니다.

Configuration $configName
{

   # User Data
    Registry SetRegisteredOwner
    {
        Ensure = 'Present'
        Force = $True
        Key = $Node.RegisteredKey
        ValueName = $Node.RegisteredOwnerValue
        ValueType = 'String'
        ValueData = $Node.RegisteredOwnerData
    }
    #
    # Script to delete the config
    #
    script DeleteCommandAnalysisCache
    {
        DependsOn = "[Registry]SetRegisteredOwner"
        getscript = "@{}"
        testscript = 'Remove-Item -Path $env:windir\system32\config\systemprofile\AppData\Local\Microsoft\Windows\PowerShell\CommandAnalysis -Force -Recurse -ErrorAction SilentlyContinue -ErrorVariable ev | out-null;$true'
        setscript = '$true'
    }
}

다음을 통해 공유

DSC(원하는 상태 구성)의 알려진 문제 및 제한 사항

주요 변경 내용: DSC 구성에서 암호를 암호화/암호 해독하는 데 사용된 인증서가 WMF 5.0 RTM 설치 후 작동하지 않을 수 있음

DSC cmdlet이 WMF 5.0 RTM 설치 후 실패할 수 있음

WMF 5.0 RTM이 WMF 5.0 Production Preview 위에 설치된 경우 DSC cmdlet이 작동하지 않을 수 있음

DebugMode에서 Get-DscConfiguration을 사용하는 동안 LCM이 불안정한 상태가 될 수 있음

Stop-DscConfiguration이 DebugMode에서 응답하지 않을 수 있습니다.

DebugMode에 자세한 오류 메시지가 표시되지 않음

Get-DscConfigurationStatus cmdlet에서 Invoke-DscResource 작업을 검색할 수 없음

Get-DscConfigurationStatus에서 끌어오기 주기 작업을 Consistency 형식으로 반환함

Invoke-DscResource cmdlet이 메시지를 생성된 순서대로 반환하지 않음

Invoke-DscResource와 함께 사용할 경우 DSC 리소스를 쉽게 디버그할 수 없음

동일한 노드에 대한 다양한 부분 구성 문서에 동일한 리소스 이름이 포함될 수 없음

Start-DscConfiguration –UseExisting이 -Credential에서 작동하지 않음

DSC 구성에서 노드 이름으로 사용된 IPv6 주소

`Class-Based` DSC 리소스의 디버깅

DSC 클래스 기반 리소스의 $script 범위에 정의된 변수 및 함수는 여러 DSC 리소스 호출에서 유지되지 않습니다.

리소스가 PSDscRunAsCredential을 사용하는 경우의 DSC 리소스 디버깅

DSC 복합 리소스에서는 PsDscRunAsCredential이 지원되지 않음

Get-DscResource -Syntax에 PsDscRunAsCredential이 올바르게 반영되지 않음

WindowsOptionalFeature를 Windows 7에서 사용할 수 없음

클래스 기반 DSC 리소스의 경우, Import-DscResource -ModuleVersion이 예상대로 작동하지 않을 수 있습니다.

레지스트리 리소스와 같은 일부 DSC 리소스는 요청을 처리하는 데 시간이 오래 걸릴 수 있습니다.

추가 리소스

다음을 통해 공유

DSC(원하는 상태 구성)의 알려진 문제 및 제한 사항

주요 변경 내용: DSC 구성에서 암호를 암호화/암호 해독하는 데 사용된 인증서가 WMF 5.0 RTM 설치 후 작동하지 않을 수 있음

DSC cmdlet이 WMF 5.0 RTM 설치 후 실패할 수 있음

WMF 5.0 RTM이 WMF 5.0 Production Preview 위에 설치된 경우 DSC cmdlet이 작동하지 않을 수 있음

DebugMode에서 Get-DscConfiguration을 사용하는 동안 LCM이 불안정한 상태가 될 수 있음

Stop-DscConfiguration이 DebugMode에서 응답하지 않을 수 있습니다.

DebugMode에 자세한 오류 메시지가 표시되지 않음

Get-DscConfigurationStatus cmdlet에서 Invoke-DscResource 작업을 검색할 수 없음

Get-DscConfigurationStatus에서 끌어오기 주기 작업을 Consistency 형식으로 반환함

Invoke-DscResource cmdlet이 메시지를 생성된 순서대로 반환하지 않음

Invoke-DscResource와 함께 사용할 경우 DSC 리소스를 쉽게 디버그할 수 없음

동일한 노드에 대한 다양한 부분 구성 문서에 동일한 리소스 이름이 포함될 수 없음

Start-DscConfiguration –UseExisting이 -Credential에서 작동하지 않음

DSC 구성에서 노드 이름으로 사용된 IPv6 주소

Class-Based DSC 리소스의 디버깅

DSC 클래스 기반 리소스의 $script 범위에 정의된 변수 및 함수는 여러 DSC 리소스 호출에서 유지되지 않습니다.

리소스가 PSDscRunAsCredential을 사용하는 경우의 DSC 리소스 디버깅

DSC 복합 리소스에서는 PsDscRunAsCredential이 지원되지 않음

Get-DscResource -Syntax에 PsDscRunAsCredential이 올바르게 반영되지 않음

WindowsOptionalFeature를 Windows 7에서 사용할 수 없음

클래스 기반 DSC 리소스의 경우, Import-DscResource -ModuleVersion이 예상대로 작동하지 않을 수 있습니다.

레지스트리 리소스와 같은 일부 DSC 리소스는 요청을 처리하는 데 시간이 오래 걸릴 수 있습니다.

추가 리소스

`Class-Based` DSC 리소스의 디버깅