Compartilhar via

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 Pull ( Serviço DSC de Recurso do Windows) é um componente com suporte do Windows Server, no entanto, não há planos para 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 do Azure Policy chamado configuração de convidado. O serviço de configuração de convidado combina recursos da Extensão 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 máquinas híbridas por meio de servidores habilitados para Arc.

Antes de configurar um cliente pull, você deve configurar um servidor pull. Embora esse pedido não seja obrigatório, ele ajuda na solução de problemas e ajuda a garantir que o registro foi bem-sucedido. Para configurar um servidor de pull, você pode usar os seguintes guias:

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

Configurar o LCM do cliente pull

A execução de qualquer um dos exemplos abaixo cria uma nova pasta de saída chamada PullClientConfigID e coloca um arquivo MOF de metaconfiguração lá. Nesse caso, o arquivo MOF de metaconfiguração será nomeado localhost.meta.mof.

Para aplicar a configuração, chame o cmdlet Set-DscLocalConfigurationManager , com o Path definido como o local do arquivo MOF de metaconfiguração. Por exemplo:

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

ID de configuração

Os exemplos a seguir definem a propriedade ConfigurationID do LCM como um Guid que foi criado anteriormente para essa finalidade. O ConfigurationID é o que o LCM usa para localizar a configuração apropriada no servidor de pull. O arquivo MOF de configuração no servidor de pull deve ser nomeado ConfigurationID.mof, em que ConfigurationID é o valor da propriedade ConfigurationID do LCM do nó de destino. Para obter mais informações, consulte 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 é armazenada. Para fazer isso, você deve configurar o Local Configuration Manager (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 HTTP DSC

Se o servidor de pull estiver configurado como um serviço Web, você definirá o DownloadManagerName como WebDownloadManager. O WebDownloadManager requer que você especifique um ServerUrl para a chave DownloadManagerCustomData . Você também pode especificar um valor para AllowUnsecureConnection, como no exemplo abaixo. O script a seguir configura o LCM para efetuar 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 "."

Ações para PMEs

Se o servidor de pull estiver configurado como um compartilhamento de arquivos SMB, em vez de um serviço Web, você definirá o DownloadManagerName como DscFileDownloadManager em vez do WebDownLoadManager. O DscFileDownloadManager requer que você especifique uma propriedade SourcePath no DownloadManagerCustomData. O script a seguir configura o LCM para efetuar pull de configurações de um compartilhamento SMB chamado "SmbDscShare" em um servidor chamado "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

Depois que o cliente de pull tiver sido configurado, você poderá usar os seguintes guias para executar as próximas etapas:

Consulte Também

  • Last updated on