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 posterior, consulte Configurando o Gerenciador de Configuração Local.

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

Propriedades do Gestor de Configuração Local

A lista a seguir lista as propriedades do Gerenciador de Configurações Local que você pode definir ou recuperar.

• 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 credenciais passadas em uma configuração. Para obter mais informações, consulte Deseja 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 pull. O GUID garante que o arquivo de configuração correto seja acessado.
• ConfigurationMode: Especifica como o Gerenciador de Configuração Local realmente aplica a configuração aos nós de destino. Pode ter os seguintes valores:
  • ApplyOnly: Com essa opção, o DSC aplica a configuração e não faz mais nada, a menos que uma nova configuração seja detetada, seja enviando uma nova configuração diretamente para o nó de destino ou se você estiver se conectando a um serviço pull e o DSC descobrir uma nova configuração quando verificar com o serviço pull. Se a configuração do nó de destino se desviar, nenhuma ação será executada.
  • ApplyAndMonitor: Com esta opção (que é o padrão), o DSC aplica quaisquer novas configurações, sejam elas enviadas por você diretamente para o nó de destino ou descobertas em um serviço pull. Depois disso, se a configuração do nó de destino se desviar do arquivo de configuração, o DSC relatará a discrepância nos logs. Para obter mais informações sobre o registro em log DSC, consulte Usando logs de eventos para diagnosticar erros na configuração de estado desejado.
  • ApplyAndAutoCorrect: Com esta opção, o DSC aplica quaisquer novas configurações, quer sejam enviadas por si diretamente para o nó de destino ou descobertas num serviço pull. Depois disso, se a configuração do nó de destino se desviar do arquivo de configuração, o DSC relatará a discrepância nos logs e, em seguida, tentará ajustar a configuração do nó de destino para obter conformidade com o arquivo de configuração.
• ConfigurationModeFrequencyMins: Representa a frequência (em minutos) na qual o aplicativo em segundo plano do 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 mais recente que foi baixada para o nó de destino. RefreshFrequencyMins deve ser definido como um múltiplo inteiro de ConfigurationModeFrequencyMins.
• Credencial: indica as credenciais (como acontece com 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 do gerenciador de downloads.
• DownloadManagerName: Indica o nome do gerenciador de configuração e download do módulo.
• RebootNodeIfNeeded: defina isso para $true permitir que os recursos reinicializem o nó usando o $global:DSCMachineStatus sinalizador. Caso contrário, você terá que reinicializar manualmente o nó para qualquer configuração que o exija. O valor predefinido é $false. Para usar essa configuração quando uma condição de reinicialização for decretada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot .
• RefreshFrequencyMins: Usado quando você configurou um serviço pull. Representa a frequência (em minutos) na qual o Gerenciador de Configurações Local entra em contato com um serviço 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 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 mais recente que foi baixada para o nó de destino. Se RefreshFrequencyMins não estiver definido como um múltiplo inteiro de ConfigurationModeFrequencyMins, o sistema irá arredondar para cima. O valor padrão é 30.
• RefreshMode: Os valores possíveis são Push (o padrão) e Pull. Na configuração "push", você deve colocar um arquivo de configuração em cada nó de destino, usando qualquer computador cliente. No modo "pull", você deve configurar um serviço pull para o Local Configuration Manager entrar em contato e acessar os arquivos de configuração.

Exemplo de atualização das definições do Gestor de Configuração Local

Você pode atualizar as configurações do Gerenciador de Configuração 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, você pode usar o cmdlet Set-DscLocalConfigurationManager , conforme mostrado no exemplo a seguir.

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

Para ver as definições atuais do Gestor de Configuração Local, pode utilizar o cmdlet Get-DscLocalConfigurationManager . Se você invocar esse cmdlet sem parâmetros, por padrão, ele obterá as definições do Gerenciador de Configuração Local para o nó no qual você o executa. Para especificar outro nó, use o parâmetro CimSession com este cmdlet.