Instellen van een pull-client met behulp van configuratie-IDSetting up a pull client using configuration ID

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

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 configureert 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 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

In het script wordt de ConfigurationRepositoryWeb blok definieert de pull-server.In the script, the ConfigurationRepositoryWeb block defines the pull server. De ServerURLThe ServerURL

Nadat dit script wordt uitgevoerd, maakt deze een nieuwe map voor uitvoer met de naam PullClientConfigID en er een MOF-bestand metaconfiguratie plaatst.After this script runs, it creates a new output folder named PullClientConfigID 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. Bijvoorbeeld: Set-DSCLocalConfigurationManager localhost –Path .\PullClientConfigID –Verbose.For example: Set-DSCLocalConfigurationManager localhost –Path .\PullClientConfigID –Verbose.

Configuratie-IDConfiguration ID

Het script wordt de ConfigurationID eigenschap van LCM naar een GUID die eerder is gemaakt voor dit doel (u kunt een GUID maken met behulp van de New-Guid cmdlet).The script sets the ConfigurationID property of LCM to a GUID that had been previously created for this purpose (you can create a GUID by using the New-Guid cmdlet). De ConfigurationID is de LCM gebruikt de juiste configuratie vinden op de pull-server.The ConfigurationID is what the LCM uses to find the appropriate configuration on the pull server. Het MOF-bestand van de configuratie op de pull-server moet de naam ConfigurationID_MOF, waarbij _ConfigurationID is de waarde van de ConfigurationID eigenschap van het doel LCM van het knooppunt.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.

SMB pull-serverSMB pull server

Gebruiken om een client te pull configuraties stellen van een SMB-server, een ConfigurationRepositoryShare blok.To set up a client to pull configurations from an SMB server, use a ConfigurationRepositoryShare block. In een ConfigurationRepositoryShare blok, u het pad naar de server opgeven door de bronpad eigenschap.In a ConfigurationRepositoryShare block, you specify the path to the server by setting the SourcePath property. De volgende metaconfiguratie configureert het doelknooppunt voor het ophalen van een SMB-pull-server met de naam SMBPullServer.The following metaconfiguration configures the target node to pull from an SMB pull server named SMBPullServer.

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

        }     
    }
}
PullClientConfigID

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

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

Zie ookSee Also