使用 PowerShell 4.0 中的組態識別碼設定提取用戶端

適用於:Windows PowerShell 4.0、Windows PowerShell 5.0

這很重要

提取伺服器 (Windows 功能 DSC 服務) 是 Windows Server 支援的元件,但沒有提供新功能或功能的計劃。 我們希望您知道,較新版本的 DSC 現已正式推出,由名為 來賓設定的 Azure 原則功能管理。 來賓設定服務結合了 DSC 延伸模組、Azure 自動化狀態設定的功能,以及客戶意見反應中最常要求的功能。 來賓設定也包括透過 已啟用 Arc 的伺服器的混合式機器支援。

在設定提取用戶端之前,您應該設定提取伺服器。 雖然此順序不是必需的,但它有助於進行故障排除,並幫助您確保註冊成功。 若要設定提取伺服器,您可以使用下列指南:

每個目標節點都可以配置為下載配置、資源,甚至報告其狀態。 下列各節說明如何使用 SMB 共用或 HTTP DSC 提取伺服器來設定提取用戶端。 當節點的LCM重新整理時,它會連線到已設定的位置、以下載任何指派的組態。 如果節點上不存在任何必要的資源,它會自動從設定的位置下載這些資源。 如果節點已設定 報表伺服器,則會報告作業的狀態。

設定提取用戶端 LCM

執行下列任何範例都會建立名為 PullClientConfigID 的新輸出資料夾,並將中繼組態 MOF 檔案放在其中。 在此情況下,中繼組態 MOF 檔案將命名 localhost.meta.mof為 。

若要套用設定,請呼叫 Set-DscLocalConfigurationManager Cmdlet,並將 [路徑] 設定為中繼設定 MOF 檔案的位置。 例如:

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

組態標識碼

下列範例會將 LCM 的 ConfigurationID 屬性設定為先前為此目的所建立的 Guid 。 ConfigurationID 是 LCM 用來在提取伺服器上尋找適當設定的內容。 提取伺服器上的組態 MOF 檔案必須命名 ConfigurationID.mof為 ,其中 ConfigurationID 是目標節點 LCM 的 ConfigurationID 屬性值。 如需詳細資訊,請參閱將組態發佈至提取伺服器 (v4/v5)。

您可以使用下列範例建立隨機 Guid 。

[System.Guid]::NewGuid()

設定提取用戶端以下載組態

每個用戶端都必須在 提取 模式下進行設定,並提供儲存其配置的提取伺服器 URL。 為此,您必須使用必要的資訊配置本地配置管理器(LCM)。 若要設定 LCM,您可以使用 LocalConfigurationManager 區塊建立特殊類型的設定。 如需設定 LCM 的詳細資訊,請參閱 設定本機 Configuration Manager。

HTTP DSC 提取伺服器

如果提取伺服器設定為 Web 服務,請將 DownloadManagerName 設定為 WebDownloadManager。 WebDownloadManager 要求您指定 ServerUrl 至 DownloadManagerCustomData 索引鍵。 您也可以指定 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 ,而不是 WebDownLoadManager。 DscFileDownloadManager 需要您在 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 "."

後續步驟

設定提取用戶端之後,您可以使用下列指南來執行後續步驟:

另請參閱