Update-DscConfiguration

참조

모듈:: PSDesiredStateConfiguration

끌어오기 서버에서 업데이트된 구성을 확인하고 적용합니다.

Syntax

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

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Update-DscConfiguration 끌어오기 서버에 연결하고, 노드의 현재 구성과 다른 경우 구성을 다운로드한 다음, 구성을 컴퓨터에 적용합니다.

이 cmdlet은 Windows RT 8.1, Windows 8.1 및 Windows Server 2012 R2에 대한 2014년 11월 업데이트 롤업의 일부로만 사용할 수 있습니다.

예제

예제 1: 구성 업데이트

Update-DscConfiguration -Wait -Verbose

이 명령을 실행한 후 서버는 등록된 끌어오기 서비스에 연결하고, 할당된 최신 구성을 다운로드한 다음, 적용합니다. Wait 및 Verbose 매개 변수는 선택 사항입니다. 대화형으로 작업할 때 이러한 매개 변수를 결합하면 구성을 적용할 때 진행률 및 성공 또는 실패에 대한 실시간 피드백을 사용할 수 있습니다.

예제 2: CIM 세션을 통해 연결하여 구성 업데이트

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

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

두 번째 명령은 에 저장된 $SessionCimSession에 지정된 컴퓨터를 업데이트합니다. 명령은 Wait 매개 변수를 지정합니다. 콘솔은 현재 명령이 완료될 때까지 추가 명령을 수락하지 않습니다.

매개 변수

-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은 이 매개 변수가 지정하는 컴퓨터에 구성 설정을 적용합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
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

-JobName

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

기본적으로 Windows PowerShell 이름이 JobN이고 여기서 N은 정수입니다.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-Wait

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

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

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

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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