Configurando o LCM no PowerShell 4.0

Aplica-se a: Windows PowerShell 4.0

Para obter informações relacionadas ao Windows PowerShell 5.0 e versões posteriores, consulte Configurando o Gerenciador de Configurações Local.

O Gerenciador de Configurações Local (LCM) é o mecanismo de Configuração de Estado Desejado (DSC) do Windows PowerShell. É executado em todos os nós de destino e é responsável por chamar os recursos de configuração que estão incluídos em um script de configuração DSC. Este tópico lista as propriedades do Gerenciador de Configurações Local e descreve como você pode modificar as configurações do Gerenciador de Configurações Local em um nó de destino.

Propriedades do Gerenciador de Configurações Local

O exemplo a seguir lista as propriedades do Gerenciador de Configurações Local que podem ser definidas ou recuperadas.

• AllowModuleOverwrite: controla se as novas configurações baixadas do serviço de configuração têm permissão para substituir as antigas no nó de destino. Os valores possíveis são True e False.
• CertificateID: a impressão digital de um certificado usado para proteger as credenciais passadas em uma configuração. Para obter mais informações, consulte Quer proteger credenciais na Configuração de Estado Desejado do Windows PowerShell?
• ConfigurationID: indica um GUID que é usado para obter um arquivo de configuração específico de um serviço de pull. O GUID garante que o arquivo de configuração correto seja acessado.
• ConfigurationMode: especifica como o Gerenciador de Configurações Local realmente aplica a configuração aos nós de destino. Ele pode usar os seguintes valores:
  • ApplyOnly: com essa opção, a DSC aplicará a configuração e não fará nada além disso, a menos que uma nova configuração seja detectada quando você enviar uma nova configuração diretamente para o nó de destino, ou se você estiver se conectando a um serviço de pull e o DSC descobrir uma nova configuração quando verificar com o serviço de pull. Nenhuma ação será executada se a configuração de destino estiver dessincronizada.
  • ApplyAndMonitor: com essa opção (que é o padrão), a DSC aplica a todas as novas configurações, independentemente de terem sido enviadas por você diretamente para o nó de destino ou descobertas em um serviço de pull. Por conseguinte, se a configuração do nó de destino estiver dessincronizada em relação ao arquivo de configuração, a DSC relatará a discrepância em logs. Para obter mais informações sobre o registro em log de DSC, consulte Usando Logs de Evento para Diagnosticar Erros na Configuração de Estado Desejado.
  • ApplyAndAutoCorrect: com essa opção, a DSC aplica todas as novas configurações, independentemente de terem sido enviadas por você diretamente para o nó de destino ou descobertas em um serviço de pull. Depois disso, se a configuração do nó de destino estiver dessincronizada em relação ao arquivo de configuração, a DSC relatará a discrepância em logs e tentará ajustar a configuração do nó de destino para colocar em conformidade com o arquivo de configuração.
• ConfigurationModeFrequencyMins: representa a frequência (em minutos) em que o aplicativo em segundo plano de DSC tenta implementar a configuração atual no nó de destino. O valor padrão é 15. Esse valor pode ser definido em conjunto com RefreshMode. Quando RefreshMode é definido como PULL, o nó de destino entra em contato com o serviço de configuração em um intervalo definido por RefreshFrequencyMins e baixa a configuração atual. Independentemente do valor RefreshMode, no intervalo definido por ConfigurationModeFrequencyMins, o mecanismo de consistência aplica a configuração que foi baixada por último ao nó de destino. RefreshFrequencyMins deve ser definido como um número inteiro, múltiplo de ConfigurationModeFrequencyMins.
• Credential: indica credenciais (como é o caso de Get-Credential) necessárias para acessar recursos remotos, como entrar em contato com o serviço de configuração.
• DownloadManagerCustomData: representa uma matriz que contém dados personalizados específicos para o gerenciador de downloads.
• DownloadManagerName: indica o nome da configuração e o gerenciador de downloads do módulo.
• RebootNodeIfNeeded: defina como $true para permitir que os recursos reinicializem o nó usando o sinalizador $global:DSCMachineStatus. Caso contrário, você precisará reinicializar manualmente o nó para qualquer configuração que exigir. O valor padrão é $false. Para usar essa configuração quando uma condição de reinicialização for representada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot.
• RefreshFrequencyMins: usado ao configurar um serviço de pull. Representa a frequência (em minutos) em que o Gerenciador de Configurações Local contata um serviço de pull para baixar a configuração atual. Esse valor pode ser definido em conjunto com ConfigurationModeFrequencyMins. Quando RefreshMode é definido como PULL, o nó de destino entra em contato com o serviço de pull em um intervalo definido por RefreshFrequencyMins e baixa a configuração atual. No intervalo definido por ConfigurationModeFrequencyMins, o mecanismo de consistência aplica a configuração que foi baixada por último ao nó de destino. Se RefreshFrequencyMins não for definido como um número inteiro, múltiplo de ConfigurationModeFrequencyMins, será arredondado pelo sistema. O valor padrão é 30.
• RefreshMode: os valores possíveis são Push (o padrão) e Pull. Na configuração de "push", é necessário colocar um arquivo de configuração em cada nó de destino, usando qualquer computador cliente. No modo de "pull", configure um serviço de pull para o Gerenciador de Configurações Local contatar e acessar os arquivos de configuração.

Exemplo de atualização das configurações do Gerenciador de Configurações Local

Você pode atualizar as configurações do Gerenciador de Configurações Local de um nó de destino incluindo um bloco LocalConfigurationManager dentro do bloco de nó em um script de configuração, conforme mostrado no exemplo a seguir.

Configuration ExampleConfig
{
    Node "Server001"
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called
# Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

A execução do script no exemplo anterior gera um arquivo MOF que especifica e armazena as configurações desejadas. Para aplicar as configurações, pode-se usar o cmdlet Set-DscLocalConfigurationManager, conforme mostrado no exemplo a seguir.

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

Para ver as configurações do Gerenciador de Configurações Local atual, você pode usar o cmdlet Get-DscLocalConfigurationManager. Se você invocar esse cmdlet sem parâmetros, ele receberá, por padrão, as configurações do Gerenciador de Configurações Local para o nó no qual será executado. Para especificar outro nó, use o parâmetro CimSession com esse cmdlet.