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 servidor remoto de pull.In pull mode, pull clients are configured to get their desired state configurations from a remote pull server. Da mesma forma, o servidor 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 server 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 uma tarefa agendada que executa uma verificação periódica de conformidade na configuração do nó.Each one of the pull clients has a scheduled task that performs a periodic compliance check on the configuration of the node. Quando o evento é disparado na primeira vez, faz com que o Gerenciador de Configurações Local (LCM) no cliente de pull faça uma solicitação ao servidor de pull para especificar a configuração no LCM.When the event is triggered the first time, it the Local Configuration Manager (LCM) on the pull client makes a request to the pull server to get the configuration specified in the LCM. Se essa configuração existir no servidor de pull e passar nas verificações iniciais de validação, ela será transmitida para o cliente pull, no qual será executada pelo LCM.If that configuration exists on the pull server, and it passes initial validation checks, the configuration is transmitted 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 servidor de pull em intervalos regulares, especificados pela propriedade RefreshModeFrequency do LCM.The LCM checks for updated configurations on the pull server 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.

Para saber mais sobre a configuração de um Servidor de Pull de DSC, veja Configurando um servidor de pull da Web de DSC.For more information on setting up a DSC Pull Server, see Setting up a DSC web pull server.

Se preferir tirar proveito de um serviço online para hospedar a funcionalidade de Servidor de Pull, consulte o serviço de DSC de Automação do Azure.If you would prefer to take advantage of an online service to host Pull Server functionality, see the Azure Automation DSC service.

Os tópicos a seguir explicam como configurar clientes e servidores de pull:The following topics explain how to set up pull servers and clients: