在 PowerShell 4.0 中使用配置 ID 设置拉取客户端

适用于:Windows PowerShell 4.0、Windows PowerShell 5.0

重要

拉取服务器(Windows 功能 DSC 服务)是 Windows Server 受支持的组件,但没有计划提供新特性或功能。 我们希望你知道,较新版本的 DSC 现已正式发布,由名为 “来宾配置”的 Azure Policy 功能管理。 来宾配置服务结合了 DSC 扩展、Azure 自动化状态配置的功能以及客户反馈中最常请求的功能。 来宾配置还包括通过 已启用 Arc 的服务器的混合计算机支持。

在设置请求客户端之前,您应该设置请求服务器。 虽然此顺序不是必需的,但它有助于进行故障排除,并帮助您确保注册成功。 要设置请求服务器,您可以使用以下指南:

每个目标节点都可以配置为下载配置、资源,甚至报告其状态。 以下部分介绍如何配置具有 SMB 共享或 HTTP DSC 请求服务器的请求客户端。 当节点的 LCM 刷新时,它将访问配置的位置以下载任何分配的配置。 如果节点上不存在任何必需的资源,它将自动从配置的位置下载这些资源。 如果节点配置了 Report Server,则它将报告作的状态。

配置请求客户端 LCM

执行以下任何示例都会创建一个名为 PullClientConfigID 的新输出文件夹,并将元配置 MOF 文件放在其中。 在这种情况下,元配置 MOF 文件将被命名为 localhost.meta.mof

要应用配置,请调用 Set-DscLocalConfigurationManager cmdlet,并将 Path 设置为元配置 MOF 文件的位置。 例如:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.

配置 ID

以下示例将 LCM 的 ConfigurationID 属性设置为以前为此目的创建的 Guid 。 ConfigurationID 是 LCM 用于在拉取服务器上查找适当配置的 ConfigurationID 。 拉取服务器上的配置 MOF 文件必须命名 ConfigurationID.mof为 ,其中 ConfigurationID 是目标节点的 LCM 的 ConfigurationID 属性的值。 有关更多信息,请参阅将配置发布到请求服务器 (v4/v5)。

可以使用以下示例创建随机 Guid

[System.Guid]::NewGuid()

设置 Pull Client 以下载配置

每个客户端都必须配置为 Pull 模式,并为其配置提供存储其配置的 Pull server URL。 为此,您必须使用必要的信息配置本地配置管理器 (LCM)。 若要配置 LCM,请使用 LocalConfigurationManager 块创建特殊类型的配置。 有关配置 LCM 的更多信息,请参阅 配置本地配置管理器

HTTP DSC 拉取服务器

如果拉取服务器设置为 Web 服务,则将 DownloadManagerName 设置为 WebDownloadManagerWebDownloadManager 要求您为 DownloadManagerCustomData 键指定 ServerUrl。 您还可以为 AllowUnsecureConnection 指定一个值,如以下示例所示。 以下脚本将 LCM 配置为从名为“PullServer”的服务器拉取配置。

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24"
        RefreshMode = "PULL"
        DownloadManagerName = "WebDownloadManager"
        RebootNodeIfNeeded = $true
        RefreshFrequencyMins = 30
        ConfigurationModeFrequencyMins = 30
        ConfigurationMode = "ApplyAndAutoCorrect"
        DownloadManagerCustomData = @{
            ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"
            AllowUnsecureConnection = "TRUE"
        }
    }
}
PullClientConfigId -Output "."

中小企业份额

如果拉取服务器设置为 SMB 文件共享,而不是 Web 服务,则将 DownloadManagerName 设置为 DscFileDownloadManager ,而不是 WebDownLoadManagerDscFileDownloadManager 要求在 DownloadManagerCustomData 中指定 SourcePath 属性。 以下脚本将 LCM 配置为从名为“CONTOSO-SERVER”的服务器上名为“SmbDscShare”的 SMB 共享拉取配置。

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    }
}
PullClientConfigId -Output "."

后续步骤

配置拉取客户端后,可以使用以下指南执行后续步骤:

另请参阅