Compartilhar via

Configurar um cliente de pull usando nomes de configuração no PowerShell 5.0 e posterior

  • Artigo

Aplica-se a: Windows PowerShell 5.0

Importante

O Servidor de Recepção (Recurso do Windows Serviço DSC) é um componente compatível com o Windows Server, no entanto, não há planos de oferecer novos recursos ou funcionalidades. Gostaríamos que você soubesse que uma versão mais recente do DSC agora está em disponibilidade geral, gerenciada por um recurso de Azure Policy configuração de convidado nomeada. O serviço de configuração de convidado combina recursos de extensão de DSC, State Configuration da Automação do Azure e os recursos mais solicitados dos comentários dos clientes. A configuração de convidado também inclui suporte a computadores híbridos por meio de servidores habilitados para Arc.

Antes de configurar um cliente de pull, você deve configurar um servidor de pull. Embora essa ordem não seja obrigatória, ela ajuda na solução de problemas e ajuda a garantir que o registro seja bem-sucedido. Para configurar um servidor de pull, você pode usar os guias a seguir:

Cada nó de destino pode ser configurado para baixar configurações, recursos e até mesmo relatar seu status. As seções a seguir mostram como configurar um cliente de pull com um compartilhamento SMB ou servidor de pull de DSC HTTP. Quando o nó do LCM for atualizado, ele entrará em contato com a localização configurada para baixar as configurações atribuídas. Se algum dos recursos necessários não existir no nó, ele será baixado automaticamente da localização configurada. Se o nó for configurado com um Servidor de relatório, ele relatará o status da operação.

Observação

Este tópico se aplica ao PowerShell 5.0. Para obter informações sobre como configurar um cliente de pull no PowerShell 4.0, confira Configurar um cliente de pull usando uma ID de configuração no PowerShell 4.0

Configurar o LCM do cliente de pull

A execução de qualquer um dos exemplos abaixo cria uma nova pasta de saída denominada PullClientConfigName e coloca nela um arquivo MOF de metaconfiguração. Nesse caso, o arquivo MOF de metaconfiguração será nomeado 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. Por exemplo:

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

Nome da configuração

Os exemplos a seguir definem a propriedade ConfigurationName do LCM como o nome de uma configuração compilada anteriormente, criada para essa finalidade. O ConfigurationName é usado pelo LCM para localizar a configuração apropriada no servidor de pull. O arquivo MOF da configuração no servidor de pull deve ser denominado <ConfigurationName>.mof, nesse caso, "ClientConfig.mof". Para obter mais informações, confira Publicar configurações em um servidor de pull (v4/v5).

Configurar um cliente de pull para baixar configurações

Cada cliente deve ser configurado no modo Pull e receber a URL do servidor de pull em que sua configuração está armazenada. Para fazer isso, você precisa configurar o Gerenciador de Configurações Local (LCM) com as informações necessárias. Para configurar o LCM, é criado um tipo especial de configuração, decorada com o atributo DSCLocalConfigurationManager. Para obter mais informações sobre como configurar o LCM, consulte Configurando o Gerenciador de Configurações Local.

O script a seguir configura o LCM para efetuar o pull de configurações de um servidor chamado "CONTOSO-PullSrv".

  • No script, o bloco ConfigurationRepositoryWeb define o servidor de pull. A propriedade ServerURL especifica o ponto de extremidade para o servidor de pull.

  • A propriedade RegistrationKey é uma chave compartilhada entre todos os nós de cliente para um servidor de pull e esse servidor de pull. O mesmo valor é armazenado em um arquivo no servidor de pull.

    Observação

    As chaves de registro funcionam apenas com servidores de pull da Web. Você ainda deve usar ConfigurationID com um servidor de pull de SMB. > Para obter informações sobre como configurar um servidor de pull usando ConfigurationID, consulte Configurando um cliente de pull usando a ID de configuração

  • A propriedade ConfigurationNames em uma matriz que especifica os nomes das configurações destinadas ao nó do cliente. >Observação: Se você especificar mais de um valor em ConfigurationNames, também será necessário especificar blocos PartialConfiguration na configuração. >Para obter informações sobre configurações parciais, consulte PowerShell Desired State Configuration configurações parciais.

[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

Configurar um cliente de pull para baixar recursos

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 na mesma localização em que seus arquivos “.mof” estão armazenados. Você também pode especificar locais diferentes nos quais os clientes podem baixar recursos. 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).

O exemplo a seguir mostra uma metaconfiguração que configura um cliente para baixar configurações de um servidor de pull e recursos de um compartilhamento SMB.

[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'
        }

        ResourceRepositoryShare SMBResources
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigNames

Configurar um cliente de pull para relatar o status

Você pode usar um único servidor de pull para emissão de relatórios, recursos e configurações. A emissão de relatórios não está configurada para os clientes por padrão. Para configurar um cliente para relatar o status, você precisa criar um bloco ReportRepositoryWeb. 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.

Observação

Um servidor de relatório não pode ser um compartilhamento SMB.

[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'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }
    }
}
PullClientConfigNames

Consulte Também