다음을 통해 공유

Test-DscConfiguration

  • 참조
모듈:
PSDesiredStateConfiguration

노드의 실제 구성이 원하는 구성과 일치하는지 테스트합니다.

구문

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Description

Test-DscConfiguration cmdlet은 노드의 실제 구성이 원하는 구성과 일치하는지 테스트합니다. 컴퓨터 이름 또는 CIM(일반 정보 모델) 세션을 사용하여 구성을 테스트할 컴퓨터를 지정합니다. 대상 컴퓨터를 지정하지 않으면 cmdlet은 로컬 컴퓨터의 구성을 테스트합니다.

원하는 구성과 실제 구성이 일치하면 cmdlet은 문자열 값 'True'를 반환합니다. 그렇지 않으면 문자열 값 'False'를 반환합니다.

예제

예제 1: 로컬 컴퓨터에 대한 테스트 구성

Test-DscConfiguration

이 명령은 로컬 컴퓨터에 대한 구성을 테스트합니다.

예제 2: 지정된 컴퓨터에 대한 테스트 구성

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

다음은 CIM 세션에서 지정한 컴퓨터에서 구성을 테스트하는 예제입니다. 이 예제에서는 cmdlet과 함께 사용할 Server01 컴퓨터에 대한 CIM 세션을 만듭니다. 또는 지정된 여러 컴퓨터에 cmdlet을 적용하는 CIM 세션 배열을 만듭니다.

첫 번째 명령은 New-CimSession cmdlet을 사용하여 CIM 세션을 만든 다음 CimSession 개체를 $Session 변수에 저장합니다. 이 명령은 암호를 묻는 메시지를 표시합니다. 자세한 내용은 Get-Help New-CimSession입력합니다.

두 번째 명령은 $Session 변수에 저장된 CimSession 개체(이 경우 Server01이라는 컴퓨터)로 식별되는 컴퓨터의 구성을 테스트합니다.

예제 3: 자세한 결과를 사용하여 구성 테스트

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

이 명령은 ComputerName 매개 변수로 지정된 컴퓨터 집합에 대한 구성을 테스트하고 전체 상태, 원하는 상태에 있는 리소스, 원하는 상태 및 컴퓨터 이름에 없는 리소스를 포함하는 자세한 정보를 반환합니다.

예제 4: 폴더에 지정된 테스트 구성

Test-DscConfiguration -Path "C:\Dsc\Configurations"

이 명령은 Path 매개 변수로 지정된 폴더에 정의된 구성을 테스트합니다. 구성은 각각 구성 파일의 파일 이름으로 식별되는 컴퓨터 집합에 대해 테스트됩니다.

예제 5: 파일에 지정된 테스트 구성

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

이 명령은 ComputerName 매개 변수로 지정된 컴퓨터 집합에 대해 파일에 정의된 구성을 테스트합니다.

매개 변수

-AsJob

이 cmdlet이 명령을 백그라운드 작업으로 실행한다는 것을 나타냅니다.

AsJob 매개 변수를 지정하는 경우 명령은 작업을 나타내는 개체를 반환한 다음 명령 프롬프트를 표시합니다. 작업이 완료될 때까지 세션에서 작업을 계속할 수 있습니다. 작업이 로컬 컴퓨터에 만들어지고 원격 컴퓨터의 결과가 자동으로 로컬 컴퓨터로 반환됩니다. 작업을 관리하려면 작업 cmdlet을 사용합니다. 작업 결과를 얻으려면 Receive-Job cmdlet을 사용합니다.

이 매개 변수를 사용하려면 원격으로 로컬 및 원격 컴퓨터를 구성해야 하며 Windows Vista 이상 버전의 Windows 운영 체제에서는 관리자 권한으로 실행 옵션을 사용하여 Windows PowerShell을 열어야 합니다. 자세한 내용은 about_Remote_Requirements참조하세요.

Windows PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs 및 about_Remote_Jobs참조하세요.

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

-CimSession

원격 세션 또는 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름 또는 세션 개체(예: New-CimSession 또는 get-CimSession cmdlet 출력)를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.

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

-ComputerName

이 cmdlet이 구성을 테스트하는 컴퓨터 이름의 배열을 지정합니다. cmdlet은 이러한 컴퓨터에 대한 Path 매개 변수로 지정된 위치에서 구성 문서를 테스트합니다.

형식:String[]
별칭:CN, ServerName
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Credential

대상 컴퓨터의 사용자 이름 및 암호를 PSCredential 개체로 지정합니다. PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 Get-Help Get-Credential입력합니다.

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

-Detailed

이 cmdlet은 구성 문서를 노드의 원하는 상태와 비교한 자세한 결과를 반환합니다. 결과에는 전체 상태, 원하는 상태에 있는 리소스, 원하는 상태가 아닌 리소스 및 컴퓨터 이름과 같은 정보가 포함됩니다.

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

-Path

구성 문서 파일이 포함된 폴더의 경로를 지정합니다. cmdlet은 ComputerName 또는 CimSession 매개 변수로 지정된 컴퓨터의 원하는 상태에 대해 구성을 테스트합니다.

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

-ReferenceConfiguration

구성 문서 파일의 경로를 지정합니다. 이 cmdlet은 ComputerName 또는 CimSession 매개 변수로 지정된 컴퓨터의 실제 상태에 대해 구성을 테스트합니다.

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

-ThrottleLimit

cmdlet을 실행하기 위해 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수를 생략하거나 0 값을 입력하면 Windows PowerShell은 컴퓨터에서 실행되는 CIM cmdlet 수에 따라 cmdlet에 대한 최적의 제한 제한을 계산합니다. 제한 제한은 세션이나 컴퓨터가 아닌 현재 cmdlet에만 적용됩니다.

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