Start-DscConfiguration

모듈:

PSDesiredStateConfiguration Module v1.1

노드에 구성을 적용합니다.

구문

ComputerNameAndPathSet (기본값)

Start-DscConfiguration
    [[-Path] <String>]
    [[-ComputerName] <String[]>]
    [-Wait]
    [-Force]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimSessionAndPathSet

Start-DscConfiguration
    [[-Path] <String>]
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-ThrottleLimit <Int32>]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerNameAndUseExistingSet

Start-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Wait]
    [-Force]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-UseExisting]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimSessionAndUseExistingSet

Start-DscConfiguration
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-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 개체로 식별된 컴퓨터에 적용합니다. 이 예제에서 $Session 변수에는 Server01이라는 컴퓨터에 대한 CIM 세션만 포함됩니다. 이 명령은 구성을 적용합니다. 이 명령은 구성된 각 컴퓨터에 대한 작업 개체를 만듭니다.

매개 변수

-CimSession

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

매개 변수 속성

형식:	CimSession[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

CimSessionAndPathSet

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

CimSessionAndUseExistingSet

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

-ComputerName

컴퓨터 이름의 배열을 지정합니다. 이 매개 변수는 Path 매개 변수에 구성 문서가 있는 컴퓨터를 배열에 지정된 컴퓨터로 제한합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	중국, 서버 이름

매개 변수 집합

ComputerNameAndPathSet

Position:	1
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ComputerNameAndUseExistingSet

Position:	1
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

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

-Credential

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

매개 변수 속성

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

매개 변수 집합

ComputerNameAndPathSet

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

ComputerNameAndUseExistingSet

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

-Force

대상 컴퓨터에서 현재 실행 중인 구성 작업을 중지하고 새 Start-Configuration 작업을 시작합니다. 로컬 구성 관리자의 RefreshMode 속성이 끌어오기설정된 경우 이 매개 변수를 지정하면 푸시변경됩니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-JobName

작업의 이름을 지정합니다. 이 매개 변수를 지정하면 cmdlet이 작업으로 실행되고 Job 개체가 반환됩니다.

기본적으로 Windows PowerShell은 N이 정수인 JobN이라는 이름을 할당합니다.

Wait 매개 변수를 지정하는 경우 이 매개 변수를 지정하지 마세요.

매개 변수 속성

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

매개 변수 집합

(All)

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

-Path

구성 설정 파일이 포함된 폴더의 파일 경로를 지정합니다. 이 cmdlet은 지정된 경로에 설정 파일이 있는 컴퓨터에 이러한 구성 설정을 게시하고 적용합니다. 각 대상 노드에는 <NetBIOS Name>.mof형식의 설정 파일이 있어야 합니다.

매개 변수 속성

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

매개 변수 집합

ComputerNameAndPathSet

Position:	0
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CimSessionAndPathSet

Position:	0
필수:	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

-UseExisting

이 cmdlet이 기존 구성을 적용했음을 나타냅니다. 구성은 Start-DscConfiguration 사용하거나 Publish-DscConfiguration cmdlet을 사용하여 게시하여 대상 컴퓨터에 존재할 수 있습니다.

이 cmdlet에 대해 이 매개 변수를 지정하기 전에 windows PowerShell 5.0 새로운 기능의 정보를 검토합니다.

매개 변수 속성

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

매개 변수 집합

ComputerNameAndUseExistingSet

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

CimSessionAndUseExistingSet

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

-Wait

cmdlet이 모든 구성 작업을 완료할 때까지 콘솔을 차단한다는 것을 나타냅니다.

이 매개 변수를 지정하는 경우 JobName 매개 변수를 지정하지 마세요.

매개 변수 속성

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

매개 변수 집합

(All)

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	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를 참조하세요.

관련 링크

• Windows PowerShell 필요한 상태 구성 개요
• Get-DscConfiguration
• Get-DscConfigurationStatus
• Restore-DscConfiguration
• Stop-DscConfiguration
• Test-DscConfiguration
• Update-DscConfiguration