Test-DscConfiguration

  • 참조
모듈:
PSDesiredStateConfiguration

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

Syntax

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

cmdlet은 Test-DscConfiguration 노드의 실제 구성이 원하는 구성과 일치하는지 테스트합니다. 컴퓨터 이름 또는 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 세션 배열을 만듭니다.

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

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

예제 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 매개 변수를 지정하면 명령은 작업을 나타내는 개체를 반환한 다음 명령 프롬프트를 표시합니다. 작업이 완료될 때까지 세션에서 계속 작업할 수 있습니다. AsJob 매개 변수를 사용하는 경우 이 명령은 백그라운드 작업을 나타내는 개체를 즉시 반환합니다. 작업을 관리하려면 Job cmdlet을 사용합니다. 작업 결과를 얻으려면 cmdlet을 Receive-Job 사용합니다.

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

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

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceConfiguration

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수를 생략하거나 값을 0 입력한 경우 Windows PowerShell 컴퓨터에서 실행되는 CIM cmdlet 수에 따라 cmdlet에 대한 최적의 제한 제한을 계산합니다. 스로틀 제한은 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False