다음을 통해 공유

Get-DscConfiguration

모듈:
PSDesiredStateConfiguration Module v1.1

노드의 현재 구성을 가져옵니다.

구문

Default (기본값) 

Get-DscConfiguration
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

Description

Get-DscConfiguration cmdlet은 구성이 있는 경우 노드의 현재 구성을 가져옵니다. CIM(일반 정보 모델) 세션을 사용하여 컴퓨터를 지정합니다. 대상 컴퓨터를 지정하지 않으면 cmdlet은 로컬 컴퓨터에서 구성을 가져옵니다.

예제

예제 1: 로컬 컴퓨터에 대한 구성 가져오기

Get-DscConfiguration

이 명령은 로컬 컴퓨터의 현재 상태를 가져옵니다.

예제 2: 지정된 컴퓨터에 대한 구성 가져오기

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

이 예제에서는 CIM 세션에서 지정한 컴퓨터에서 현재 상태를 가져옵니다. 이 예제에서는 cmdlet과 함께 사용할 Server01 컴퓨터에 대한 CIM 세션을 만듭니다. 또는 지정된 여러 컴퓨터에 cmdlet을 적용하는 CIM 세션 배열을 만듭니다.

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

두 번째 명령은 $Session 변수에 저장된 CimSession 개체(이 경우 Server01이라는 컴퓨터)로 식별되는 컴퓨터에 대한 현재 구성을 가져옵니다.

매개 변수

-AsJob

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

매개 변수 속성

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

매개 변수 집합

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

-CimSession

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

매개 변수 속성

형식:

CimSession[]

Default value:None
와일드카드 지원:False
DontShow:False
별칭:세션

매개 변수 집합

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

-ThrottleLimit

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

매개 변수 속성

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

매개 변수 집합

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

CommonParameters

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