Aplicando configuraçõesEnacting configurations

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

Há duas maneiras de aplicar configurações da Configuração de Estado Desejado (DSC) do PowerShell: modo de push e modo de pull.There are two ways to enact PowerShell Desired State Configuration (DSC) configurations: push mode and pull mode.

Modo de pushPush mode

Modo de pushPush mode

O modo de push se refere a um usuário aplicando ativamente uma configuração a um nó de destino chamando o cmdlet Start-DscConfiguration.Push mode refers to a user actively applying a configuration to a target node by calling the Start-DscConfiguration cmdlet.

Depois de criar e compilar uma configuração, você pode aplicá-la no modo de push chamando o cmdlet Start-DscConfiguration, definindo o parâmetro -Path do cmdlet para o caminho em que se encontra o MOF de configuração.After creating and compiling a configuration, you can enact it in push mode by calling the Start-DscConfiguration cmdlet, setting the -Path parameter of the cmdlet to the path where the configuration MOF is located. Por exemplo, se o MOF da configuração estiver localizado em C:\DSC\Configurations\localhost.mof, você o aplicaria no computador local com o seguinte comando: Start-DscConfiguration -Path 'C:\DSC\Configurations'For example, if the configuration MOF is located at C:\DSC\Configurations\localhost.mof, you would apply it to the local machine with the following command: Start-DscConfiguration -Path 'C:\DSC\Configurations'

Observação: por padrão, a DSC executa uma configuração como um trabalho em segundo plano.Note: By default, DSC runs a configuration as a background job. Para executar a configuração interativamente, chame o Start-DscConfiguration com o parâmetro -Wait.To run the configuration interactively, call the Start-DscConfiguration with the -Wait parameter.

Modo de pullPull mode

Modo de pullPull Mode

No modo de pull, os clientes de pull são configurados para obter suas configurações de estado desejado de um serviço de pull remoto.In pull mode, pull clients are configured to get their desired state configurations from a remote pull service. Da mesma forma, o serviço de pull foi configurado para hospedar o serviço de DSC e recebeu as configurações e os recursos necessários para os clientes de pull.Likewise, the pull service has been set up to host the DSC service, and has been provisioned with the configurations and resources that are required by the pull clients. Cada um dos clientes de pull tem um evento agendado que executa uma verificação periódica de conformidade na configuração do nó.Each of the pull clients has a scheduled event that performs a periodic compliance check on the configuration of the node. Quando o evento é disparado pela primeira vez, o LCM (Gerenciador de Configurações Local) no cliente de pull faz uma solicitação ao serviço de pull para obter a configuração especificada no LCM.When the event is triggered the first time, the Local Configuration Manager (LCM) on the pull client makes a request to the pull service to get the configuration specified in the LCM. Se essa configuração existir no serviço de pull e passar nas verificações iniciais de validação, ela será baixada para o cliente de pull, no qual será executada pelo LCM.If that configuration exists on the pull service, and it passes initial validation checks, the configuration is downloaded to the pull client, where it is then executed by the LCM.

O LCM verifica se o cliente está em conformidade com a configuração em intervalos regulares, especificados pela propriedade ConfigurationModeFrequencyMins do LCM.The LCM checks that the client is in compliance with the configuration at regular intervals specified by the ConfigurationModeFrequencyMins property of the LCM. O LCM verifica configurações atualizadas no serviço de pull em intervalos regulares, especificados pela propriedade RefreshModeFrequency do LCM.The LCM checks for updated configurations on the pull service at regular intervals specified by the RefreshModeFrequency property of the LCM. Para saber mais sobre como configurar o LCM, veja Configurando o Gerenciador de Configurações Local.For information about configuring the LCM, see Configuring the Local Configuration Manager.

A solução recomendada para hospedar um Serviço de Pull é o serviço de nuvem do DSC, Automação do Azure.The recommended solution for hosting a Pull Service, is the DSC cloud service, Azure Automation. Essa solução hospedada fornece gerenciamento gráfico, relatórios e administração centralizada.This is hosted solution provides graphical management, reporting, and centralized administration.

Para saber mais sobre a configuração de um Serviço de Pull no Windows Server, confira Configuração de um servidor de pull da Web de DSC.For more information on setting up a Pull Service on Windows Server, see Setting up a DSC web pull server. Entenda, no entanto, que essa implementação tem recursos limitados e exige alguma integração "por conta própria".Understand however, that this implementation has limited features and does require some "do it yourself" integration.

Os tópicos a seguir explicam o serviço de pull e os clientes:The following topics explain pull service and clients: