Configurando um cliente de pull usando nomes de configuraçãoSetting up a pull client using configuration names

Aplica-se a: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

Cada nó de destino deve ser instruído a usar o modo de pull e receber a URL em que possa contatar o servidor de pull para obter as configurações.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. Para fazer isso, você precisa configurar o Gerenciador de Configurações Local (LCM) com as informações necessárias.To do this, you have to configure the Local Configuration Manager (LCM) with the necessary information. Para configurar o LCM, é criado um tipo especial de configuração, decorada com o atributo DSCLocalConfigurationManager.To configure the LCM, you create a special type of configuration, decorated with the DSCLocalConfigurationManager attribute. Para obter mais informações sobre como configurar o LCM, consulte Configurando o Gerenciador de Configurações Local.For more information about configuring the LCM, see Configuring the Local Configuration Manager.

Observação: este tópico se aplica ao PowerShell 5.0.Note: This topic applies to PowerShell 5.0. Para obter informações sobre como configurar um cliente de pull no PowerShell 4.0, consulte Configurando um cliente de pull usando uma ID de configuração no PowerShell 4.0.For information on setting up a pull client in PowerShell 4.0, see Setting up a pull client using configuration ID in PowerShell 4.0

O script a seguir configura o LCM para efetuar o pull de configurações de um servidor chamado "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

No script, o bloco ConfigurationRepositoryWeb define o servidor de pull.In the script, the ConfigurationRepositoryWeb block defines the pull server. A propriedade ServerURL especifica o ponto de extremidade para o servidor de pull.The ServerURL property specifies the endpoint for the pull server.

A propriedade RegistrationKey é uma chave compartilhada entre todos os nós de cliente para um servidor de pull e esse servidor de pull.The RegistrationKey property is a shared key between all client nodes for a pull server and that pull server. O mesmo valor é armazenado em um arquivo no servidor de pull.The same value is stored in a file on the pull server.

A propriedade ConfigurationNames em uma matriz que especifica os nomes das configurações destinadas ao nó do cliente.The ConfigurationNames property is an array that specifies the names of the configurations intended for the client node. No servidor de pull, o arquivo MOF de configuração para esse nó do cliente deve ser nomeado ConfigurationNames.mof, em que ConfigurationNames corresponde ao valor da propriedade ConfigurationNames definida nessa metaconfiguração.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.

Observação: se você especificar mais de um valor em ConfigurationNames, também será necessário especificar blocos PartialConfiguration na configuração.Note: If you specify more than one value in the ConfigurationNames, you must also specify PartialConfiguration blocks in your configuration. Para obter informações sobre configurações parciais, veja Configurações parciais da Configuração de Estado Desejado do PowerShell.For information about partial configurations, see PowerShell Desired State Configuration partial configurations.

Depois de ser executado, esse script cria uma nova pasta de saída chamada PullClientConfigNames e coloca um arquivo MOF de metaconfiguração nela.After this script runs, it creates a new output folder named PullClientConfigNames and puts a metaconfiguration MOF file there. Nesse caso, o arquivo MOF de metaconfiguração será nomeado localhost.meta.mof.In this case, the metaconfiguration MOF file will be named localhost.meta.mof.

Para aplicar a configuração, chame o cmdlet Set-DscLocalConfigurationManager, com Path definido como a localização do arquivo MOF de metaconfiguração.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.

Observação: as chaves de registro funcionam apenas com servidores de pull da Web.Note: Registration keys work only with web pull servers. Você ainda deve usar ConfigurationID com um servidor de pull de SMB.You must still use ConfigurationID with an SMB pull server. Para obter informações sobre como configurar um servidor de pull usando ConfigurationID, consulte Configurando um cliente de pull usando uma ID de configuraçãoFor information about configuring a pull server by using ConfigurationID, see Setting up a pull client using configuration ID

Servidores de recurso e relatórioResource and report servers

Se você especificar apenas um bloco ConfigurationRepositoryWeb ou ConfigurationRepositoryShare em sua configuração LCM (como no exemplo anterior), o cliente de pull efetuará pull dos recursos do servidor especificado, mas não enviará relatórios a ele.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. Você pode usar um único servidor de pull para emissão de relatórios, recursos e configurações, mas é preciso criar um bloco ReportRepositoryWeb para configurar o relatório.You can use a single pull server for configurations, resources, and reporting, but you have to create a ReportRepositoryWeb block to set up reporting. O exemplo a seguir mostra uma metaconfiguração que configura um cliente para efetuar pull de recursos e configurações, além de enviar dados de relatórios, para um único servidor de pull.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

Também é possível especificar servidores de pull diferentes para recursos e relatórios.You can also specify different pull servers for resources and reporting. Para especificar um servidor de recurso, utilize um bloco ResourceRepositoryWeb (para um servidor de pull da Web) ou um bloco ResourceRepositoryShare (para um servidor de pull de SMB).To specify a resource server, you use either a ResourceRepositoryWeb (for a web pull server) or a ResourceRepositoryShare block (for an SMB pull server). Para especificar um servidor de relatório, utilize um bloco ReportRepositoryWeb.To specify a report server, you use a ReportRepositoryWeb block. Um servidor de relatório não pode ser um servidor de SMB.A report server cannot be an SMB server. A metaconfiguração a seguir configura um cliente de pull para obter suas configurações de CONTOSO PullSrv e seus recursos de CONTOSO ResourceSrv, bem como enviar relatórios de status para 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

Consulte TambémSee Also