Publish-DscConfiguration

  • 참조
모듈:
PSDesiredStateConfiguration

DSC 구성을 컴퓨터 집합에 게시합니다.

Syntax

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

cmdlet은 Publish-DscConfiguration 컴퓨터 집합에 DSC(Windows PowerShell Desired State Configuration) 구성 문서를 게시합니다. 이 cmdlet은 구성을 적용하지 않습니다. 구성은 UseExisting 매개 변수와 함께 사용되거나 DSC 엔진이 일관성 주기를 실행할 때 Start-DscConfiguration cmdlet에 의해 적용됩니다. DSC 엔진을 LCM(로컬 Configuration Manager)라고도 합니다.

이 cmdlet은 여러 구성 문서의 조각이 배달될 때 특히 유용합니다. 여러 구성 문서 조각이 배달되면 이전 구성 문서 조각을 덮어씁니다.

예제

예제 1: 원격 컴퓨터에 구성 게시

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

이 명령은 원격 컴퓨터에 구성을 게시합니다. cmdlet을 실행하는 사용자는 원격 컴퓨터의 관리자여야 합니다.

매개 변수

-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

대상 디바이스에 액세스하는 데 사용되는 자격 증명을 지정합니다.

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

-Force

cmdlet을 강제로 마칩니다. 로컬 Configuration Manager 새로 고침 모드가 PULL로 설정된 경우 이 매개 변수를 사용하면 푸시로 변경되고 DSC 구성을 게시할 수 있습니다. 또한 보류 중인 DSC 구성이 있는 경우 이 매개 변수를 사용하면 보류 중인 구성을 덮어씁니다.

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

-Path

대상 컴퓨터에 게시할 구성이 포함된 경로를 지정합니다.

Type:String
Position:0
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

-WhatIf

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

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