Konfigurowanie klienta ściągania przy użyciu identyfikatorów konfiguracji w programie PowerShell 5,0 i nowszychSet up a Pull Client using Configuration IDs in PowerShell 5.0 and later

Dotyczy: Windows PowerShell 5,0Applies To: 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.

Uwaga

Ten temat dotyczy programu PowerShell 5,0.This topic applies to PowerShell 5.0. Aby uzyskać informacje na temat konfigurowania klienta ściągania w programie PowerShell 4,0, zobacz Konfigurowanie klienta ściągania przy użyciu identyfikatora konfiguracji w programie powershell 4,0For information on setting up a pull client in PowerShell 4.0, see Setting up a pull client using configuration ID in PowerShell 4.0

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. Na przykład:For example:

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

Identyfikator konfiguracjiConfiguration ID

Poniższe przykłady ustawiają Właściwość CONFIGURATIONID LCM na Identyfikator GUID , który został wcześniej utworzony w tym celu.The examples below sets 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 lub przy użyciu polecenia cmdlet New-GUID .You can create a random Guid using the example below, or by using the New-Guid cmdlet.

[System.Guid]::NewGuid()

Aby uzyskać więcej informacji na temat używania identyfikatorów GUID w środowisku, zobacz temat Planowanie identyfikatorów GUID.For more information about using Guids in your environment, see Plan for Guids.

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, uzupełniony atrybutem DSCLocalConfigurationManager .To configure the LCM, you create a special type of configuration, decorated with the DSCLocalConfigurationManager attribute. 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

Poniższy skrypt konfiguruje LCM do ściągania konfiguracji z serwera o nazwie "CONTOSO-PullSrv".The following script configures the LCM to pull configurations from a server named "CONTOSO-PullSrv".

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }
    }
}
PullClientConfigID

W skrypcie blok ConfigurationRepositoryWeb definiuje serwer ściągania.In the script, the ConfigurationRepositoryWeb block defines the pull server. ServerURL określa adres URL ŚCIĄGAnia DSCThe ServerUrl specifies the url of the DSC Pull

Udział SMBSMB Share

Poniższy skrypt konfiguruje LCM do ściągania konfiguracji z udziału SMB \\SMBPullServer\Pull .The following script configures the LCM to pull configurations from the SMB Share \\SMBPullServer\Pull.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Pull'
        }
    }
}
PullClientConfigID

W skrypcie blok ConfigurationRepositoryShare definiuje serwer ściągania, który w tym przypadku jest tylko udziałem SMB.In the script, the ConfigurationRepositoryShare block defines the pull server, which in this case, is just an SMB share.

Konfigurowanie klienta ściągania w celu pobierania zasobówSet up a Pull Client to download Resources

Jeśli określisz tylko blok ConfigurationRepositoryWeb lub CONFIGURATIONREPOSITORYSHARE w konfiguracji LCM (jak w poprzednich przykładach), klient ściągania będzie ściągał zasoby z tej samej lokalizacji, w której zostaną pobrane konfiguracje.If you specify only the ConfigurationRepositoryWeb or ConfigurationRepositoryShare block in your LCM configuration (as in the previous examples), the pull client will pull resources from the same location it retrieves its configurations. Można również określić oddzielne lokalizacje dla zasobów.You can also specify separate locations for resources. Aby określić lokalizację zasobu jako oddzielny serwer, użyj bloku ResourceRepositoryWeb .To specify a resource location as a separate server, use the ResourceRepositoryWeb block. Aby określić lokalizację zasobu jako udział SMB, użyj bloku ResourceRepositoryShare .To specify a resource location as an SMB share, use the ResourceRepositoryShare block.

Uwaga

Możesz połączyć ConfigurationRepositoryWeb z ResourceRepositoryShare lub ConfigurationRepositoryShare z ResourceRepositoryWeb .You can combine ConfigurationRepositoryWeb with ResourceRepositoryShare or ConfigurationRepositoryShare with ResourceRepositoryWeb . Przykłady tego nie są pokazane poniżej.Examples of this are not shown below.

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

Poniższa konfiguracja konfiguracji konfiguruje klienta ściągania w celu pobrania jego konfiguracji z contoso-PullSrv i jego zasobów z firmy contoso-ResourceSrv .The following metaconfiguration configures a pull client to get its configurations from CONTOSO-PullSrv and its resources from CONTOSO-ResourceSrv .

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

Udział SMBSMB Share

W poniższym przykładzie przedstawiono konfigurację, która konfiguruje klienta do ściągania konfiguracji z udziału SMB \\SMBPullServer\Configurations i zasobów z udziału SMB \\SMBPullServer\Resources .The following example shows a metaconfiguration that sets up a client to pull configurations from the SMB share \\SMBPullServer\Configurations, and resources from the SMB share \\SMBPullServer\Resources.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Configurations'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

Automatycznie pobieraj zasoby w trybie wypychaniaAutomatically download Resources in Push Mode

Począwszy od programu PowerShell 5,0, klienci ściągania mogą pobierać moduły z udziału SMB, nawet jeśli są skonfigurowane do trybu wypychania .Beginning in PowerShell 5.0, your pull clients can download modules from an SMB share, even when they are configured for Push mode. Jest to szczególnie przydatne w scenariuszach, w których nie chcesz konfigurować serwera ściągania.This is especially useful in scenarios where you do not want to set up a Pull Server. Bloku ResourceRepositoryShare można użyć bez określenia ConfigurationRepositoryShare .The ResourceRepositoryShare block can be used without specifying a ConfigurationRepositoryShare . W poniższym przykładzie przedstawiono konfigurację, która konfiguruje klienta do ściągania zasobów z udziału SMB \\SMBPullServer\Resources .The following example shows a metaconfiguration that sets up a client to pull resources from an SMB Share \\SMBPullServer\Resources. Gdy węzeł zostanie wypychany do konfiguracji, automatycznie pobierze wymagane zasoby z określonego udziału.When the Node is PUSHED a configuration, it will automatically download any required resources, from the share specified.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

Konfigurowanie klienta ściągania w celu raportowania stanuSet up a Pull Client to report status

Domyślnie węzły nie będą wysyłać raportów do skonfigurowanego serwera ściągania.By default, Nodes will not send reports to a configured Pull Server. Można użyć jednego serwera ściągania do konfiguracji, zasobów i raportowania, ale trzeba utworzyć blok ReportRepositoryWeb , aby skonfigurować raportowanie.You can use a single pull server for configurations, resources, and reporting, but you have to create a ReportRepositoryWeb block to set up reporting.

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

W poniższym przykładzie przedstawiono konfigurację, która konfiguruje klienta do ściągania konfiguracji i zasobów oraz wysyłania danych raportowania do pojedynczego serwera ściągania.The following example shows a metaconfiguration that sets up a client to pull configurations and resources, and send reporting data, to a single pull server.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

Aby określić serwer raportów, należy użyć bloku ReportRepositoryWeb .To specify a report server, you use a ReportRepositoryWeb block. Serwer raportów nie może być serwerem SMB.A report server cannot be an SMB server. Poniższa konfiguracja konfiguracji konfiguruje klienta ściągania, aby pobrać jego konfiguracje z contoso-PullSrv i jego zasobów z firmy contoso-ResourceSrv i wysyłać raporty o stanie do firmy Contoso-ReportSrv :The following metaconfiguration configures a pull client to get its configurations from CONTOSO-PullSrv and its resources from CONTOSO-ResourceSrv , and to send status reports to CONTOSO-ReportSrv :

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }

        ReportServerWeb CONTOSO-ReportSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

Udział SMBSMB Share

Serwer raportów nie może być udziałem SMB.A report server cannot be an SMB share.

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