Partilhar via

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

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0

Importante

O Pull Server (Windows Feature DSC-Service) é um componente suportado do Windows Server, no entanto, não há planos para oferecer novos recursos ou capacidades. gostaríamos que você soubesse que uma versão mais recente do DSC agora está disponível ao público, gerenciada por um recurso da Política do Azure chamado configuração de convidado. O serviço de configuração de convidado combina recursos de Extensão DSC, Configuração de Estado de Automação do Azure e os recursos mais comumente 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 essa ordem não seja necessária, ela ajuda na solução de problemas e ajuda a garantir que o registro foi bem-sucedido. Para configurar um servidor 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 pull com um compartilhamento SMB ou HTTP DSC Pull Server. Quando o LCM do nó for atualizado, ele entrará em contato com o local configurado para baixar todas as configurações atribuídas. Se não existirem recursos necessários 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 para o local 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 como um Guid que foi criado anteriormente para essa finalidade. O ConfigurationID é o que o LCM usa para encontrar a configuração apropriada no servidor de receção. O arquivo MOF de configuração no servidor pull deve ser nomeado ConfigurationID.mof, onde ConfigurationID é o valor da propriedade ConfigurationID do LCM do nó de destino. Para obter mais informações, consulte Publicar configurações em um servidor pull (v4/v5).

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

[System.Guid]::NewGuid()

Configurar um Pull Client para baixar configurações

Cada cliente deve ser configurado no modo Pull e receber a URL do servidor pull onde sua configuração está armazenada. Para fazer isso, você precisa configurar o Gerenciador de Configuração 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ção Local.

Servidor de Pull HTTP DSC

Se o servidor pull estiver configurado como um serviço Web, defina 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 extrair 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 pull estiver configurado como um compartilhamento de arquivos SMB, em vez de um serviço Web, defina 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 extrair 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 pull tiver sido configurado, você poderá usar os seguintes guias para executar as próximas etapas:

Ver também

  • Last updated on