Configurar um cliente de pull usando IDs de configuração no PowerShell 4.0

Aplica-se a: Windows PowerShell 4.0, 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:

• Configurar um servidor de pull SMB de DSC
• Configurar um servidor de pull HTTP de DSC

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.

Configurar o LCM do cliente de pull

A execução de qualquer um dos exemplos abaixo cria uma nova pasta de saída denominada PullClientConfigID 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 .\PullClientConfigId –Verbose.

ID de configuração

Os exemplos abaixo definem a propriedade ConfigurationID do LCM para um Guid criado anteriormente para essa finalidade. O ConfigurationID é usado pelo LCM para localizar a configuração apropriada no servidor de pull. 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. Para obter mais informações, confira Publicar configurações em um servidor de pull (v4/v5).

Você pode criar um Guid aleatório usando o exemplo abaixo.

[System.Guid]::NewGuid()

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, crie um tipo especial de configuração, com um bloco LocalConfigurationManager. Para obter mais informações sobre como configurar o LCM, consulte Configurando o Gerenciador de Configurações Local.

Servidor de pull de DSC HTTP

Se o servidor de pull estiver configurado como um serviço Web, defina DownloadManagerName como WebDownloadManager. O WebDownloadManager exige que você especifique uma ServerUrl para a chave DownloadManagerCustomData. Você também pode especificar um valor para AllowUnsecureConnection, conforme mostrado no exemplo abaixo. O script a seguir configura o LCM para efetuar o pull de configurações de um servidor chamado "PullServer".

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24"
        RefreshMode = "PULL"
        DownloadManagerName = "WebDownloadManager"
        RebootNodeIfNeeded = $true
        RefreshFrequencyMins = 30
        ConfigurationModeFrequencyMins = 30
        ConfigurationMode = "ApplyAndAutoCorrect"
        DownloadManagerCustomData = @{
            ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"
            AllowUnsecureConnection = "TRUE"
        }
    }
}
PullClientConfigId -Output "."

Compartilhamento SMB

Se o servidor de pull for configurado como um compartilhamento de arquivos SMB, e não como um serviço Web, defina DownloadManagerName como DscFileDownloadManager em vez de WebDownLoadManager. O DscFileDownloadManager exige que você especifique uma propriedade SourcePath em DownloadManagerCustomData. O seguinte script configura o LCM para efetuar pull de configurações de um compartilhamento SMB denominado “SmbDscShare” em um servidor denominado “CONTOSO-SERVER”.

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    }
}
PullClientConfigId -Output "."

Próximas etapas

Após o cliente de pull ser configurado, você pode usar os guias a seguir para executar as próximas etapas:

• Publicar configurações em um servidor de pull (v4/v5)
• Empacotar e carregar recursos em um servidor de pull (v4)

Consulte Também

• Configurar um servidor de pull Web de DSC
• Configurar um servidor de pull SMB de DSC