Configurando o Gerenciador de Configurações Local

Aplica-se a: Windows PowerShell 5.0

O Gerenciador de Configurações Local (LCM) é o mecanismo de Configuração de Estado Desejado (DSC). Ele é executado em cada nó de destino e é responsável pela análise e aplicação das configurações que são enviadas para o nó. Também é responsável por uma série de outros aspectos da DSC, incluindo os itens a seguir.

• Determinar o modo de atualização (push ou pull).
• Especificar com que frequência um nó recebe e aplica as configurações.
• Associar o nó ao serviço de pull.
• Especificar configurações parciais.

Um tipo especial de configuração é utilizado para configurar o LCM para especificar cada um desses comportamentos. As seções a seguir descrevem como configurar o LCM.

O Windows PowerShell 5.0 introduziu novas configurações para gerenciar o Gerenciador de Configurações Local. Para obter informações sobre como configurar o LCM no Windows PowerShell 4.0, veja Configurar o Gerenciador de Configurações Local em versões anteriores do Windows PowerShell.

Escrevendo e aplicando uma configuração do LCM

Para configurar o LCM, você cria e executa um tipo especial de configuração que aplica as configurações de LCM. Para especificar uma configuração do LCM, é necessário usar o atributo DscLocalConfigurationManager. Segue uma configuração simples que define o LCM para o modo de push.

[DSCLocalConfigurationManager()]
configuration LCMConfig
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
        }
    }
}

O processo de aplicação das configurações do LCM é semelhante à aplicação de uma configuração de DSC. Você criará uma configuração do LCM, a compilará em um arquivo MOF e a aplicará ao nó. Ao contrário de configurações de DSC, você não aplica uma configuração do LCM chamando o cmdlet Start-DscConfiguration. Em vez disso, chama Set-DscLocalConfigurationManager, fornecendo o caminho até o MOF de configuração do LCM como parâmetro. Depois de aplicar a configuração do LCM, você pode ver as propriedades do LCM chamando o cmdlet Get-DscLocalConfigurationManager.

Uma configuração do LCM pode conter blocos somente para um conjunto limitado de recursos. No exemplo anterior, o único recurso chamado é Settings. Os outros recursos disponíveis são:

• ConfigurationRepositoryWeb: especifica um serviço de pull de HTTP para configurações.
• ConfigurationRepositoryShare: especifica um serviço de pull de SMB para configurações.
• ResourceRepositoryWeb: especifica um serviço de pull de HTTP para os módulos.
• ResourceRepositoryShare: especifica um compartilhamento de SMB para os módulos.
• ReportServerWeb: especifica um serviço de pull de HTTP para o qual os relatórios serão enviados.
• PartialConfiguration: fornece dados para habilitar as configurações parciais.

Configurações Básicas

Além de especificar pontos de extremidade/caminhos do serviço de pull e configurações parciais, todas as propriedades do LCM são configuradas em um bloco Settings. As seguintes propriedades estão disponíveis em um bloco Settings.

Serviço de pull

A configuração do LCM dá suporte à definição dos seguintes tipos de ponto de extremidade de serviço de pull:

• Servidor de configuração: um repositório para configurações de DSC. Defina os servidores de configuração usando blocos ConfigurationRepositoryWeb (para servidores baseados na Web) e ConfigurationRepositoryShare (para servidores baseados em SMB).
• Servidor de recursos: um repositório de recursos DSC, empacotados como módulos do PowerShell. Defina os servidores de recurso usando blocos ResourceRepositoryWeb (para servidores baseados na Web) e ResourceRepositoryShare (para servidores baseados em SMB).
• Servidor de relatório: um serviço para o qual o DSC envia dados de relatório. Defina os servidores de relatório usando blocos ReportServerWeb. Um servidor de relatório deve ser um serviço Web.

Para obter mais detalhes sobre o serviço de pull, veja Serviço de pull de Desired State Configuration.

Blocos do servidor de configuração

Para definir um servidor de configuração baseado na Web, crie um bloco ConfigurationRepositoryWeb. Um ConfigurationRepositoryWeb define as propriedades a seguir.

Um exemplo de script para simplificar a configuração do valor ConfigurationRepositoryWeb para nós locais está disponível - confira Geração de metaconfigurações de DSC

Para definir um servidor de configuração baseado em SMB, crie um bloco ConfigurationRepositoryShare. Um ConfigurationRepositoryShare define as propriedades a seguir.

Blocos do servidor de recurso

Para definir um servidor de recurso baseado na Web, crie um bloco ResourceRepositoryWeb. Um ResourceRepositoryWeb define as propriedades a seguir.

Um exemplo de script para simplificar a configuração do valor ResourceRepositoryWeb para nós locais está disponível - confira Geração de metaconfigurações de DSC

Para definir um servidor de recurso baseado em SMB, crie um bloco ResourceRepositoryShare. ResourceRepositoryShare define as propriedades a seguir.

Blocos do servidor de relatório

Para definir um servidor de relatório, crie um bloco ReportServerWeb. A função de servidor de relatório não é compatível com o serviço de pull baseado em SMB. ReportServerWeb define as propriedades a seguir.

Um exemplo de script para simplificar a configuração do valor ReportServerWeb para nós locais está disponível - confira Geração de metaconfigurações de DSC

Configurações parciais

Para definir uma configuração parcial, você cria um bloco PartialConfiguration. Para obter mais informações sobre configurações parciais, consulte Configurações parciais de DSC. PartialConfiguration define as propriedades a seguir.

Consulte Também

Conceitos

Visão geral da Configuração do Estado Desejado

Introdução à DSC de Automação do Azure

Outros recursos

Set-DscLocalConfigurationManager

Configurando um cliente de pull com nomes de configuração