Configurando um cliente de pull usando uma ID de configuraçãoSetting up a pull client using configuration ID

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, com diminuição da potência com o atributo DSCLocalConfigurationManager.To configure the LCM, you create a special type of configuration, derated 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.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

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

No script, o bloco ConfigurationRepositoryWeb define o servidor de pull.In the script, the ConfigurationRepositoryWeb block defines the pull server. A ServerURLThe ServerURL

Depois de ser executado, esse script cria uma nova pasta de saída denominada PullClientConfigID e coloca nela um arquivo MOF de metaconfiguração.After this script runs, it creates a new output folder named PullClientConfigID 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. Por exemplo: Set-DSCLocalConfigurationManager localhost –Path .\PullClientConfigID –Verbose.For example: Set-DSCLocalConfigurationManager localhost –Path .\PullClientConfigID –Verbose.

ID de configuraçãoConfiguration ID

O script define a propriedade ConfigurationID do LCM para um GUID criado anteriormente para essa finalidade (você pode criar um GUID usando o cmdlet New-Guid).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). O ConfigurationID é usado pelo LCM para localizar a configuração apropriada no servidor de pull.The ConfigurationID is what the LCM uses to find the appropriate configuration on the pull server. O arquivo MOF de configuração no servidor de pull deve ser nomeado como ConfigurationID.mof, em que ConfigurationID é o valor da propriedade ConfigurationID do nó de destino do LCM.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.

Servidor de pull de SMBSMB pull server

Para configurar um cliente para efetuar o pull de configurações de um servidor SMB, use um bloco ConfigurationRepositoryShare.To set up a client to pull configurations from an SMB server, use a ConfigurationRepositoryShare block. Em um bloco ConfigurationRepositoryShare, especifique o caminho para o servidor definindo a propriedade SourcePath.In a ConfigurationRepositoryShare block, you specify the path to the server by setting the SourcePath property. A metaconfiguração a seguir configura o nó de destino para efetuar o pull de um servidor de pull de SMB chamado 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

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

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

Consulte TambémSee Also