이전 버전의 Windows PowerShell에서 로컬 구성 관리자 구성Configuring the Local Configuration Manager in Previous Versions of Windows PowerShell

적용 대상: Windows PowerShell 4.0Applies To: Windows PowerShell 4.0

Windows PowerShell 5.0 이상과 관련된 자세한 내용은 로컬 구성 관리자 구성을 참조하세요.For information related to Windows PowerShell 5.0 and later, see Configuring the Local Configuration Manager.

로컬 구성 관리자는 Windows PowerShell DSC(필요한 상태 구성) 엔진으로서,Local Configuration Manager is the Windows PowerShell Desired State Configuration (DSC) engine. 모든 대상 노드에서 실행되며 DSC 구성 스크립트에 포함된 구성 리소스를 호출하는 일을 담당합니다.It runs on all target nodes, and it is responsible for calling the configuration resources that are included in a DSC configuration script. 이 항목에서는 로컬 구성 관리자의 속성을 나열하고 대상 노드에서 로컬 구성 관리자 설정을 수정할 수 있는 방법을 설명합니다.This topic lists the properties of Local Configuration Manager and describes how you can modify the Local Configuration Manager settings on a target node.

로컬 구성 관리자 속성Local Configuration Manager properties

다음은 설정하거나 검색할 수 있는 로컬 구성 관리자 속성 목록입니다.The following lists the Local Configuration Manager properties that you can set or retrieve.

  • AllowModuleOverwrite: 구성 서비스에서 다운로드한 새 구성이 대상 노드에 있는 이전 구성을 덮어쓰도록 허용되는지 여부를 제어합니다.AllowModuleOverwrite: Controls whether new configurations downloaded from the configuration service are allowed to overwrite the old ones on the target node. 가능한 값은 True와 False입니다.Possible values are True and False.
  • CertificateID: 구성으로 전달된 자격 증명을 보호하는 데 사용되는 인증서의 지문입니다.CertificateID: The thumbprint of a certificate used to secure credentials passed in a configuration. 자세한 내용은 Want to secure credentials in Windows PowerShell Desired State Configuration?(Windows PowerShell 필요한 상태 구성의 자격 증명 보호가 필요하세요?)을 참조하세요.For more information see Want to secure credentials in Windows PowerShell Desired State Configuration?.
  • ConfigurationID: 풀 서비스에서 특정 구성 파일을 가져오는 데 사용되는 GUID를 나타냅니다.ConfigurationID: Indicates a GUID which is used to get a particular configuration file from a pull service. 이 GUID는 올바른 구성 파일에 액세스하도록 해줍니다.The GUID ensures that the correct configuration file is accessed.
  • ConfigurationMode: 로컬 구성 관리자가 실제로 구성을 대상 노드에 적용하는 방법을 지정합니다.ConfigurationMode: Specifies how the Local Configuration Manager actually applies the configuration to the target nodes. 이 속성에 가능한 값은 다음과 같습니다.It can take the following values:
    • ApplyOnly: 이 옵션을 사용하면 새 구성을 대상 노드에 직접 전송하여 새 구성이 검색되지 않은 경우 또는 풀 서비스에 연결하고 풀 서비스에서 확인하면 DSC에서 새 구성을 검색하는 경우, DSC가 구성을 적용하는 작업만을 수행합니다.ApplyOnly: With this option, DSC applies the configuration and does nothing further unless a new configuration is detected, either by you sending a new configuration directly to the target node or if you are connecting to a pull service and DSC discovers a new configuration when it checks with the pull service. 대상 노드의 구성이 변경되지 않는 경우 아무 작업도 수행되지 않습니다.If the target node’s configuration drifts, no action is taken.
    • ApplyAndMonitor: 이 옵션(기본값)을 사용하면 대상 노드에 직접 전송했든지 아니면 풀 서비스에서 검색되었든지 관계없이 DSC에서 모든 새 구성을 적용합니다.ApplyAndMonitor: With this option (which is the default), DSC applies any new configurations, whether sent by you directly to the target node or discovered on a pull service. 그 후 대상 노드의 구성이 구성 파일과 달라지면, DSC에서 로그 불일치를 보고합니다.Thereafter, if the configuration of the target node drifts from the configuration file, DSC reports the discrepancy in logs. DSC 로깅에 대한 자세한 내용은 Using Event Logs to Diagnose Errors in Desired State Configuration(이벤트 로그를 사용하여 필요한 상태 구성에 있는 오류 진단)을 참조하세요.For more about DSC logging, see Using Event Logs to Diagnose Errors in Desired State Configuration.
    • ApplyAndAutoCorrect: 이 옵션을 사용하면, 작업자가 대상 노드에 직접 전송했든지, 아니면 풀 서비스에서 검색되었든지 관계없이 DSC에서 모든 새 구성을 적용합니다.ApplyAndAutoCorrect: With this option, DSC applies any new configurations, whether sent by you directly to the target node or discovered on a pull service. 그 후 대상 노드의 구성이 구성 파일과 달라지면, DSC에서 로그 불일치를 보고한 다음, 구성 파일에 따라 가져올 대상 노드 구성에 대한 조정을 시도합니다.Thereafter, if the configuration of the target node drifts from the configuration file, DSC reports the discrepancy in logs, and then attempts to adjust the target node configuration to bring in compliance with the configuration file.
  • ConfigurationModeFrequencyMins: DSC의 백그라운드 응용 프로그램이 대상 노드에서 현재 구성에 대한 구현을 시도하는 빈도(분 단위)를 나타냅니다.ConfigurationModeFrequencyMins: Represents the frequency (in minutes) at which the background application of DSC attempts to implement the current configuration on the target node. 기본값은 15입니다.The default value is 15. 이 값은 RefreshMode와 함께 설정할 수 있습니다.This value can be set in conjunction with RefreshMode. RefreshMode를 PULL로 설정하면 대상 노드에서는 RefreshFrequencyMins로 설정한 간격으로 구성 서비스에 연결하여 현재 구성을 다운로드합니다.When RefreshMode is set to PULL, the target node contacts the configuration service at an interval set by RefreshFrequencyMins and downloads the current configuration. RefreshMode 값에 관계없이 ConfigurationModeFrequencyMins로 설정한 간격으로, 대상 노드에 다운로드한 최신 구성을 일관성 엔진이 적용합니다.Regardless of the RefreshMode value, at the interval set by ConfigurationModeFrequencyMins, the consistency engine applies the latest configuration that was downloaded to the target node. RefreshFrequencyMins는 ConfigurationModeFrequencyMins의 정수 배로 설정해야 합니다.RefreshFrequencyMins should be set to an integer multiple of ConfigurationModeFrequencyMins.
  • Credential: 구성 서비스 연결과 같이, 원격 리소스에 액세스하는 데 필요한 자격 증명(Get-Credential과 마찬가지로)을 나타냅니다.Credential: Indicates credentials (as with Get-Credential) required to access remote resources, such as to contact the configuration service.
  • DownloadManagerCustomData: 다운로드 관리자에 고유한 사용자 지정 데이터를 포함하는 배열을 나타냅니다.DownloadManagerCustomData: Represents an array that contains custom data specific to the download manager.
  • DownloadManagerName: 구성 및 모듈 다운로드 관리자의 이름을 나타냅니다.DownloadManagerName: Indicates the name of the configuration and module download manager.
  • RebootNodeIfNeeded: 대상 노드에서의 특정 구성 변경 내용은 대상 노드를 다시 시작해야 적용될 수 있습니다.RebootNodeIfNeeded: Certain configuration changes on a target node might require it to be restarted for the changes to be applied. 이 속성의 값이 True면, 구성이 완전히 적용되자마자 더 이상의 경고 없이 노드가 다시 시작됩니다.With the value True, this property will restart the node as soon as the configuration has been completely applies, without further warning. False(기본값)일 경우에는, 구성은 완료되지만 노드는 수동으로 다시 시작해야 변경 내용이 적용됩니다.If False (the default value), the configuration will be completed, but the node must be restarted manually for the changes to take effect.
  • RefreshFrequencyMins: 풀 서비스를 설정하면 사용됩니다.RefreshFrequencyMins: Used when you have set up a pull service. 로컬 구성 관리자가 현재 구성을 다운로드하기 위해 풀 서비스에 연결하는 빈도(분)를 나타냅니다.Represents the frequency (in minutes) at which the Local Configuration Manager contacts a pull service to download the current configuration. 이 값은 ConfigurationModeFrequencyMins와 함께 설정할 수 있습니다.This value can be set in conjunction with ConfigurationModeFrequencyMins. RefreshMode를 PULL로 설정하면 대상 노드에서는 RefreshFrequencyMins로 설정한 간격으로 풀 서비스에 연결하여 현재 구성을 다운로드합니다.When RefreshMode is set to PULL, the target node contacts the pull service at an interval set by RefreshFrequencyMins and downloads the current configuration. 그러면 ConfigurationModeFrequencyMins로 설정한 간격으로, 대상 노드에 다운로드한 최신 구성을 일관성 엔진이 적용합니다.At the interval set by ConfigurationModeFrequencyMins, the consistency engine then applies the latest configuration that was downloaded to the target node. RefreshFrequencyMins가 ConfigurationModeFrequencyMins의 정수 배로 설정되어 있지 않으면 시스템에서 반올림합니다.If RefreshFrequencyMins is not set to an integer multiple of ConfigurationModeFrequencyMins, the system will round it up. 기본값은 30입니다.The default value is 30.
  • RefreshMode: 가능한 값은 Push(기본값)와 Pull입니다.RefreshMode: Possible values are Push (the default) and Pull. "밀어넣기" 구성에서는 임의의 클라이언트 컴퓨터를 사용하여 각 대상 노드에 구성 파일을 배치해야 합니다.In the “push” configuration, you must place a configuration file on each target node, using any client computer. “풀” 모드에서는 연결할 로컬 구성 관리자에 대한 풀 서비스를 설정하고 구성 파일에 액세스해야 합니다.In the “pull” mode, you must set up a pull service for Local Configuration Manager to contact and access the configuration files.

로컬 구성 관리자 설정을 업데이트하는 예제Example of updating Local Configuration Manager settings

다음 예제에서 보듯이, 구성 스크립트의 노드 블록 내에 LocalConfigurationManager 블록을 포함하여 대상 노드의 로컬 구성 관리자 설정을 업데이트할 수 있습니다.You can update the Local Configuration Manager settings of a target node by including a LocalConfigurationManager block inside the node block in a configuration script, as shown in the following example.

Configuration ExampleConfig
{
    Node “Server001”
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

이전 예제의 스크립트를 실행하면 원하는 설정을 지정하고 저장하는 MOF 파일이 생성됩니다.Running the script in the previous example generates a MOF file that specifies and stores the desired settings. 설정을 적용하기 위해 다음 예제에서 보듯이 Set-DscLocalConfigurationManager cmdlet을 사용할 수 있습니다.To apply the settings, you can use the Set-DscLocalConfigurationManager cmdlet, as shown in the following example.

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

참고: Path 매개 변수의 경우, 앞의 예제에서 구성을 호출할 때 OutputPath에 대해 지정한 것과 동일한 경로를 지정해야 합니다.Note: For the Path parameter, you must specify the same path that you specified for the OutputPath parameter when you invoked the configuration in the previous example.

현재 로컬 구성 관리자 설정을 확인하기 위해 Get-DscLocalConfigurationManager cmdlet을 사용할 수 있습니다.To see the current Local Configuration Manager settings, you can use the Get-DscLocalConfigurationManager cmdlet. 매개 변수 없이 이 cmdlet을 호출하는 경우, 기본적으로, 작업자가 실행하는 노드에 대한 로컬 구성 관리자 설정을 가져오게 됩니다.If you invoke this cmdlet with no parameters, by default it will get the Local Configuration Manager settings for the node on which you run it. 다른 노드를 지정하려면 이 cmdlet에 CimSession 매개 변수를 사용합니다.To specify another node, use the CimSession parameter with this cmdlet.