Start-DscConfiguration
노드에 구성을 적용합니다.
구문
Start-DscConfiguration
[-Wait]
[-Force]
[[-Path] <String>]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
[[-Path] <String>]
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-UseExisting]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-UseExisting]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Start-DscConfiguration cmdlet은 노드에 구성을 적용합니다.
UseExisting 매개 변수와 함께 사용하면 대상 컴퓨터의 기존 구성이 적용됩니다. 컴퓨터 이름을 지정하거나 CIM(일반 정보 모델) 세션을 사용하여 구성을 적용할 컴퓨터를 지정합니다.
기본적으로 이 cmdlet은 작업을 만들고 Job 개체를 반환합니다. 백그라운드 작업에 대한 자세한 내용은 Get-Help about_Jobs입력합니다. 이 cmdlet을 대화형으로 사용하려면 Wait 매개 변수를 지정합니다.
자세한 정보 표시 매개 변수를 지정하여 cmdlet이 구성 설정을 적용할 때 수행하는 작업에 대한 세부 정보를 확인합니다.
예제
예제 1: 구성 설정 적용
Start-DscConfiguration -Path "C:\DSC\Configurations\"이 명령은 해당 폴더에 설정이 있는 모든 컴퓨터에 C:\DSC\Configurations\ 구성 설정을 적용합니다. 이 명령은 배포된 각 대상 노드에 대한 Job 개체를 반환합니다.
예제 2: 구성 설정 적용 및 구성 완료 대기
Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose이 명령은 C:\DSC\Configurations\ 구성을 로컬 컴퓨터에 적용합니다. 이 명령은 배포된 각 대상 노드에 대한 Job 개체를 반환하며, 이 경우 로컬 컴퓨터만 반환합니다. 이 예제에서는 자세한 정보 표시 매개 변수를 지정합니다. 따라서 이 명령은 계속 진행하면서 콘솔에 메시지를 보냅니다. 명령에는 Wait 매개 변수가 포함됩니다. 따라서 명령이 모든 구성 작업을 완료할 때까지 콘솔을 사용할 수 없습니다.
예제 3: CIM 세션을 사용하여 구성 설정 적용
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session이 예제에서는 지정된 컴퓨터에 구성 설정을 적용합니다. 이 예제에서는 cmdlet과 함께 사용할 Server01 컴퓨터에 대한 CIM 세션을 만듭니다. 또는 지정된 여러 컴퓨터에 cmdlet을 적용하는 CIM 세션 배열을 만듭니다.
첫 번째 명령은 New-CimSession cmdlet을 사용하여 CIM 세션을 만든 다음 CimSession 개체를 $Session 변수에 저장합니다. 이 명령은 암호를 묻는 메시지를 표시합니다. 자세한 내용은 Get-Help NewCimSession입력합니다.
두 번째 명령은 C:\DSC\Configurations 구성 설정을 $Session 변수에 저장된 CimSession 개체로 식별된 컴퓨터에 적용합니다. 이 예제에서 $Session 변수에는 Server01이라는 컴퓨터에 대한 CIM 세션만 포함됩니다. 이 명령은 구성을 적용합니다. 이 명령은 구성된 각 컴퓨터에 대한 작업 개체를 만듭니다.
매개 변수
-CimSession
원격 세션 또는 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름 또는 세션 개체(예: New-CimSession 또는 get-CimSession cmdlet 출력)를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.
| 형식: | CimSession[] |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ComputerName
컴퓨터 이름의 배열을 지정합니다. 이 매개 변수는 Path 매개 변수에 구성 문서가 있는 컴퓨터를 배열에 지정된 컴퓨터로 제한합니다.
| 형식: | String[] |
| 별칭: | CN, ServerName |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
대상 컴퓨터의 사용자 이름 및 암호를 PSCredential 개체로 지정합니다.
PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다.
자세한 내용은 Get-Help Get-Credential입력합니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Force
대상 컴퓨터에서 현재 실행 중인 구성 작업을 중지하고 새 Start-Configuration 작업을 시작합니다. 로컬 구성 관리자의 RefreshMode 속성이 끌어오기 설정된 경우 이 매개 변수를 지정하면 푸시 변경됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-JobName
작업의 이름을 지정합니다. 이 매개 변수를 지정하면 cmdlet이 작업으로 실행되고 Job 개체가 반환됩니다.
기본적으로 Windows PowerShell은 N이 정수인 JobN이라는 이름을 할당합니다.
Wait 매개 변수를 지정하는 경우 이 매개 변수를 지정하지 마세요.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
구성 설정 파일이 포함된 폴더의 파일 경로를 지정합니다. 이 cmdlet은 지정된 경로에 설정 파일이 있는 컴퓨터에 이러한 구성 설정을 게시하고 적용합니다. 각 대상 노드에는 <NetBIOS Name>.mof형식의 설정 파일이 있어야 합니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ThrottleLimit
cmdlet을 실행하기 위해 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수를 생략하거나 0 값을 입력하면 Windows PowerShell은 컴퓨터에서 실행되는 CIM cmdlet 수에 따라 cmdlet에 대한 최적의 제한 제한을 계산합니다. 제한 제한은 세션이나 컴퓨터가 아닌 현재 cmdlet에만 적용됩니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseExisting
이 cmdlet이 기존 구성을 적용했음을 나타냅니다. 구성은 Start-DscConfiguration 사용하거나 Publish-DscConfiguration cmdlet을 사용하여 게시하여 대상 컴퓨터에 존재할 수 있습니다.
이 cmdlet에 대해 이 매개 변수를 지정하기 전에 windows PowerShell 5.0 새로운 기능의 정보를 검토합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Wait
cmdlet이 모든 구성 작업을 완료할 때까지 콘솔을 차단한다는 것을 나타냅니다.
이 매개 변수를 지정하는 경우 JobName 매개 변수를 지정하지 마세요.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
