Een pull-client instellen met behulp van configuratienamenSetting up a pull client using configuration names

Van toepassing op: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

Belangrijk

De Pull-Server (Windows-onderdeel DSC-Service) is een ondersteunde onderdeel van Windows Server maar er zijn geen plannen om de nieuwe functies en mogelijkheden bieden.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. Het verdient aanbeveling om te beginnen met een overgang clients beheerd Azure Automation DSC (inclusief functies dan Pull-Server op Windows Server) of een van de community-oplossingen vermeld hier.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.

Elk doelknooppunt heeft adviseert het gebruik van pull-modus en de URL opgegeven waar deze contact opnemen met de pull-server configuraties ophalen.Each target node has to be told to use pull mode and given the URL where it can contact the pull server to get configurations. U moet de lokale Configuration Manager (LCM) configureren met de benodigde informatie om dit te doen.To do this, you have to configure the Local Configuration Manager (LCM) with the necessary information. Voor het configureren van de LCM die u maakt een speciaal soort configuratie, gedecoreerd worden met de DSCLocalConfigurationManager kenmerk.To configure the LCM, you create a special type of configuration, decorated with the DSCLocalConfigurationManager attribute. Zie voor meer informatie over het configureren van de LCM configureren van de lokale Configuration Manager.For more information about configuring the LCM, see Configuring the Local Configuration Manager.

Opmerking: dit onderwerp geldt voor PowerShell 5.0.Note: This topic applies to PowerShell 5.0. Zie voor meer informatie over het instellen van een pull-client in PowerShell 4.0 instellen van een pull-client met behulp van configuratie-ID in 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

Het volgende script voor het configureren van de LCM naar pull-configuraties van een server met de naam 'CONTOSO-PullSrv':The following script configures the LCM to pull configurations from a server named "CONTOSO-PullSrv":

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }
        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '140a952b-b9d6-406b-b416-e0f759c9c0e4'
            ConfigurationNames = @('ClientConfig')
        }
    }
}
PullClientConfigNames

In het script wordt de ConfigurationRepositoryWeb blok definieert de pull-server.In the script, the ConfigurationRepositoryWeb block defines the pull server. De ServerURL eigenschap geeft u het eindpunt voor de pull-server.The ServerURL property specifies the endpoint for the pull server.

De RegistrationKey eigenschap is een gedeelde sleutel tussen alle knooppunten van de client voor een pull-server en die pull-server.The RegistrationKey property is a shared key between all client nodes for a pull server and that pull server. Dezelfde waarde wordt opgeslagen in een bestand op de pull-server.The same value is stored in a file on the pull server.

De ConfigurationNames eigenschap is een matrix die Hiermee worden de namen van de configuraties die bedoeld zijn voor de clientknooppunt.The ConfigurationNames property is an array that specifies the names of the configurations intended for the client node. Op de pull-server de configuratie van de MOF-bestand van dit clientknooppunt moet de naam ConfigurationNamesMOF, waarbij ConfigurationNames overeenkomt met de waarde van de ConfigurationNames eigenschap die u in deze metaconfiguratie instellen.On the pull server, the configuration MOF file for this client node must be named ConfigurationNames.mof, where ConfigurationNames matches the value of the ConfigurationNames property you set in this metaconfiguration.

Opmerking: als u opgeeft meer dan één waarde in de ConfigurationNames, moet u ook opgeven PartialConfiguration gegevensblokken die zich in uw configuratie.Note: If you specify more than one value in the ConfigurationNames, you must also specify PartialConfiguration blocks in your configuration. Zie voor meer informatie over gedeeltelijke configuraties PowerShell Desired State Configuration gedeeltelijke configuraties.For information about partial configurations, see PowerShell Desired State Configuration partial configurations.

Nadat dit script wordt uitgevoerd, maakt deze een nieuwe map voor uitvoer met de naam PullClientConfigNames en er een MOF-bestand metaconfiguratie plaatst.After this script runs, it creates a new output folder named PullClientConfigNames and puts a metaconfiguration MOF file there. In dit geval wordt het MOF-bestand metaconfiguratie worden benoemd localhost.meta.mof.In this case, the metaconfiguration MOF file will be named localhost.meta.mof.

Aanroepen om toe te passen op de configuratie, de Set DscLocalConfigurationManager -cmdlet met de pad ingesteld op de locatie van het metaconfiguratie MOF-bestand.To apply the configuration, call the Set-DscLocalConfigurationManager cmdlet, with the Path set to the location of the metaconfiguration MOF file.

Set-DSCLocalConfigurationManager localhost –Path .\PullClientConfigNames –Verbose.

Opmerking: registratiesleutels werken alleen met pull-webservers.Note: Registration keys work only with web pull servers. U moet nog steeds gebruiken ConfigurationID met een SMB-pull-server.You must still use ConfigurationID with an SMB pull server. Voor informatie over het configureren van een pull-server met behulp van ConfigurationID, Zie instellen van een pull-client met behulp van configuratie-IDFor information about configuring a pull server by using ConfigurationID, see Setting up a pull client using configuration ID

Bron- en -serversResource and report servers

Als u alleen een ConfigurationRepositoryWeb of ConfigurationRepositoryShare blokkeren in uw configuratie LCM (zoals in het vorige voorbeeld), haalt de pull-client binnen resources uit de opgegeven server, maar wordt u rapporten niet naar verzenden.If you specify only a ConfigurationRepositoryWeb or ConfigurationRepositoryShare block in your LCM configuration (as in the previous example), the pull client will pull resources from the specified server, but it will not send reports to it. U kunt een enkel pull-server gebruiken voor configuraties, bronnen en rapportage, maar u moet maken een ReportRepositoryWeb blok voor het instellen van rapportage.You can use a single pull server for configurations, resources, and reporting, but you have to create a ReportRepositoryWeb block to set up reporting. Het volgende voorbeeld ziet een metaconfiguratie instellen van een client voor het pull-configuraties en resources en verzenden gegevens rapporteren aan een enkele pull-server.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 PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

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

U kunt ook verschillende pull-servers voor resources en rapportage opgeven.You can also specify different pull servers for resources and reporting. Als u wilt opgeven van een resource-server u een gebruiken een ResourceRepositoryWeb (voor een pull-webserver) of een ResourceRepositoryShare blok (voor een SMB-pull-server).To specify a resource server, you use either a ResourceRepositoryWeb (for a web pull server) or a ResourceRepositoryShare block (for an SMB pull server). Om een rapportserver die u gebruikt een ReportRepositoryWeb blok.To specify a report server, you use a ReportRepositoryWeb block. Een rapportserver mag niet een SMB-server.A report server cannot be an SMB server. De volgende metaconfiguratie configureert u een pull-client om de configuraties van CONTOSO PullSrv en de daarbij behorende bronnen uit CONTOSO ResourceSrv, en voor het verzenden van statusrapporten aan 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 PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-ResourceSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '30ef9bd8-9acf-4e01-8374-4dc35710fc90'
        }

        ReportServerWeb CONTOSO-ReportSrv
        {
            ServerURL = 'https://CONTOSO-ReportSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '6b392c6a-818c-4b24-bf38-47124f1e2f14'
        }
    }
}
PullClientConfigNames

Zie ookSee Also