Partilhar via

Configurar um Cliente Pull com IDs de Configuração no PowerShell 4.0

  • Artigo

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

Importante

O Servidor Pull (Windows Feature DSC-Service) é um componente suportado do Windows Server. No entanto, não existem planos para oferecer novas funcionalidades ou capacidades. Gostaríamos que soubesse que uma versão mais recente do DSC está agora disponível de forma geral, gerida por uma funcionalidade de Azure Policy com o nome configuração de convidado. O serviço de configuração de convidado combina funcionalidades da Extensão DSC, Automatização do Azure State Configuration e as funcionalidades mais frequentemente pedidas a partir do feedback dos clientes. A configuração de convidado também inclui suporte de máquina híbrida através de servidores compatíveis com o Arc.

Antes de configurar um cliente Pull, deve configurar um servidor Pull. Embora esta encomenda não seja necessária, ajuda na resolução de problemas e ajuda-o a garantir que o registo foi efetuado com êxito. Para configurar um servidor Pull, pode utilizar os seguintes guias:

Cada nó de destino pode ser configurado para transferir configurações, recursos e até mesmo comunicar o respetivo estado. As secções abaixo mostram-lhe como configurar um cliente Pull com uma partilha SMB ou um Servidor Pull DSC HTTP. Quando o LCM do Nó for atualizado, irá contactar a localização configurada para transferir quaisquer configurações atribuídas. Se não existirem recursos necessários no Nó, irá transferi-los automaticamente a partir da localização configurada. Se o Nó estiver configurado com um Servidor de Relatórios, reportará o estado da operação.

Configurar o LCM do cliente Pull

Executar qualquer um dos exemplos abaixo cria uma nova pasta de saída com o nome PullClientConfigID e coloca aí um ficheiro MOF de metaconfiguração. Neste caso, o ficheiro MOF de metaconfiguração terá o nome localhost.meta.mof.

Para aplicar a configuração, chame o cmdlet Set-DscLocalConfigurationManager , com o Caminho definido para a localização do ficheiro 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 que tinha sido criado anteriormente para este fim. O ConfigurationID é o que o LCM utiliza para encontrar a configuração adequada no servidor Pull. O ficheiro MOF de configuração no servidor Pull tem de ter o nome ConfigurationID.mof, em que ConfigurationID é o valor da propriedade ConfigurationID do LCM do nó de destino. Para obter mais informações, veja Publicar Configurações num Servidor Pull (v4/v5).

Pode criar um Guid aleatório com o exemplo abaixo.

[System.Guid]::NewGuid()

Configurar um Cliente Pull para transferir Configurações

Cada cliente tem de ser configurado no modo Pull e dado o URL do servidor Pull onde a configuração está armazenada. Para tal, tem de configurar o Configuration Manager 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, veja Configurar o Configuration Manager Local.

Servidor Pull DSC HTTP

Se o servidor Pull estiver configurado como um serviço Web, defina DownloadManagerName como WebDownloadManager. O WebDownloadManager requer que especifique um ServerUrl para a chave DownloadManagerCustomData . Também pode especificar um valor para AllowUnsecureConnection, como no exemplo abaixo. O script seguinte configura o LCM para solicitar configurações de um servidor com o nome "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 "."

Partilha SMB

Se o servidor Pull estiver configurado como uma partilha de ficheiros SMB, em vez de um serviço Web, defina DownloadManagerName como DscFileDownloadManager em vez de WebDownLoadManager. O DscFileDownloadManager requer que especifique uma propriedade SourcePath no DownloadManagerCustomData. O seguinte script configura o LCM para solicitar configurações de uma partilha SMB com o nome "SmbDscShare" num servidor com o nome "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 "."

Passos Seguintes

Depois de configurar o cliente Pull, pode utilizar os seguintes guias para executar os passos seguintes:

Consulte também