Konfigurowanie klienta ściągania przy użyciu identyfikatorów konfiguracji w programie PowerShell 4,0Set up a Pull Client using Configuration IDs in PowerShell 4.0

Dotyczy: Windows PowerShell 4,0, Windows PowerShell 5,0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

Ważne

Serwer ściągania (Windows Feature DSC-Service) jest obsługiwanym składnikiem systemu Windows Server, ale nie ma żadnych planów do oferowania nowych funkcji.The Pull Server (Windows Feature DSC-Service) is a supported component of Windows Server however there are no plans to offer new features or capabilities. Zalecane jest, aby rozpocząć przechodzenie zarządzanych klientów do Azure Automation DSC (obejmuje funkcje wykraczające poza serwer ściągający w systemie Windows Server) lub jedno z rozwiązań społecznościowych wymienionych w tym miejscu.It is recommended to begin transitioning managed clients to Azure Automation DSC (includes features beyond Pull Server on Windows Server) or one of the community solutions listed here.

Przed skonfigurowaniem klienta ściągania należy skonfigurować serwer ściągania.Before setting up a pull client, you should set up a pull server. Chociaż ta kolejność nie jest wymagana, pomaga w rozwiązywaniu problemów i pomaga upewnić się, że rejestracja zakończyła się pomyślnie.Though this order is not required, it helps with troubleshooting, and helps you ensure that the registration was successful. Aby skonfigurować serwer ściągania, można użyć następujących przewodników:To set up a pull server, you can use the following guides:

Każdy węzeł docelowy można skonfigurować w taki sposób, aby pobierał konfiguracje, zasoby, a nawet raportuje jego stan.Each target node can be configured to download configurations, resources, and even report its status. W poniższych sekcjach pokazano, jak skonfigurować klienta ściągania z udziałem SMB lub serwerem ściągania HTTP DSC.The sections below show you how to configure a pull client with an SMB share or HTTP DSC Pull Server. Po odświeżeniu LCM jest on dostępny w skonfigurowanej lokalizacji w celu pobrania dowolnych przypisanych konfiguracji.When the Node's LCM refreshes, it will reach out to the configured location to download any assigned configurations. Jeśli wymagane zasoby nie istnieją w węźle, zostaną automatycznie pobrane ze skonfigurowanej lokalizacji.If any required resources do not exist on the Node, it will automatically download them from the configured location. Jeśli węzeł jest skonfigurowany z serwerem raportów, zostanie on następnie zaraportowany stan operacji.If the Node is configured with a Report Server, it will then report the status of the operation.

Konfigurowanie LCM klienta ściąganiaConfigure the pull client LCM

Wykonanie dowolnego z poniższych przykładów powoduje utworzenie nowego folderu wyjściowego o nazwie PullClientConfigID i umieszczenie w nim pliku MOF konfiguracji.Executing any of the examples below creates a new output folder named PullClientConfigID and puts a metaconfiguration MOF file there. W takim przypadku plik MOF konfiguracji będzie miał nazwę localhost.meta.mof.In this case, the metaconfiguration MOF file will be named localhost.meta.mof.

Aby zastosować konfigurację, wywołaj polecenie cmdlet Set-DscLocalConfigurationManager z ścieżką ustawioną na lokalizację pliku MOF konfiguracji.To apply the configuration, call the Set-DscLocalConfigurationManager cmdlet, with the Path set to the location of the metaconfiguration MOF file. Przykład:For example:

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

Identyfikator konfiguracjiConfiguration ID

Poniższe przykłady ustawiają Właściwość CONFIGURATIONID LCM z identyfikatorem GUID , który został wcześniej utworzony w tym celu.The examples below set the ConfigurationID property of the LCM to a Guid that had been previously created for this purpose. ConfigurationID jest to, czego używa LCM, aby znaleźć odpowiednią konfigurację na serwerze ściągania.The ConfigurationID is what the LCM uses to find the appropriate configuration on the pull server. Plik MOF konfiguracji na serwerze ściągania musi mieć nazwę ConfigurationID.mof, gdzie ConfigurationID jest wartością właściwości ConfigurationID LCM węzła docelowego.The configuration MOF file on the pull server must be named ConfigurationID.mof, where ConfigurationID is the value of the ConfigurationID property of the target node's LCM. Aby uzyskać więcej informacji, zobacz Publikowanie konfiguracji na serwerze ściągania (V4/V5).For more information, see Publish Configurations to a Pull Server (v4/v5).

Można utworzyć losowy Identyfikator GUID przy użyciu poniższego przykładu.You can create a random Guid using the example below.

[System.Guid]::NewGuid()

Konfigurowanie klienta ściągania w celu pobrania konfiguracjiSet up a Pull Client to download Configurations

Każdy klient musi być skonfigurowany w trybie ściągania i mieć adres URL serwera ściągania, na którym jest przechowywana jego konfiguracja.Each client must be configured in Pull mode and given the pull server url where its configuration is stored. W tym celu należy skonfigurować Configuration Manager lokalnego (LCM) z wymaganymi informacjami.To do this, you have to configure the Local Configuration Manager (LCM) with the necessary information. Aby skonfigurować LCM, należy utworzyć specjalny typ konfiguracji z blokiem LocalConfigurationManager .To configure the LCM, you create a special type of configuration, with a LocalConfigurationManager block. Aby uzyskać więcej informacji na temat konfigurowania LCM, zobacz Konfigurowanie lokalnego Configuration Manager.For more information about configuring the LCM, see Configuring the Local Configuration Manager.

Serwer ściągania protokołu HTTP DSCHTTP DSC Pull Server

Jeśli serwer ściągania jest skonfigurowany jako usługa sieci Web, należy ustawić DownloadManagerName na webdownloadmanager.If the pull server is set up as a web service, you set the DownloadManagerName to WebDownloadManager. Element Webdownloadmanager wymaga określenia ServerURL w kluczu DownloadManagerCustomData .The WebDownloadManager requires that you specify a ServerUrl to the DownloadManagerCustomData key. Możesz również określić wartość dla AllowUnsecureConnection, jak w poniższym przykładzie.You can also specify a value for AllowUnsecureConnection, as in the example below. Poniższy skrypt konfiguruje LCM do ściągania konfiguracji z serwera o nazwie "PullServer".The following script configures the LCM to pull configurations from a server named "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 "."

Udział SMBSMB Share

Jeśli serwer ściągania jest skonfigurowany jako udział plików SMB zamiast usługi sieci Web, należy ustawić DownloadManagerName na DscFileDownloadManager , a nie element webdownloadmanager.If the pull server is set up as an SMB file share, rather than a web service, you set the DownloadManagerName to DscFileDownloadManager rather than the WebDownLoadManager. DscFileDownloadManager wymaga określenia właściwości SourcePath w DownloadManagerCustomData.The DscFileDownloadManager requires that you specify a SourcePath property in the DownloadManagerCustomData. Poniższy skrypt konfiguruje LCM do ściągania konfiguracji z udziału SMB o nazwie "SmbDscShare" na serwerze o nazwie "CONTOSO-SERVER".The following script configures the LCM to pull configurations from an SMB share named "SmbDscShare" on a server named "CONTOSO-SERVER".

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 "."

Następne krokiNext Steps

Po skonfigurowaniu klienta ściągania można użyć następujących przewodników, aby wykonać kolejne kroki:Once the pull client has been configured, you can use the following guides to perform the next steps:

Zobacz teżSee Also