Configurando um cliente de pull usando uma ID de configuração no PowerShell 4.0Setting up a pull client using configuration ID in PowerShell 4.0

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

Cada nó de destino deve ser instruído a usar o modo de pull e receber a URL em que possa contatar o servidor de pull para obter as configurações.Each target node has to be told to use pull mode and given the URL where it can contact the pull server to get configurations. Para fazer isso, você precisa configurar o Gerenciador de Configurações Local (LCM) com as informações necessárias.To do this, you have to configure the Local Configuration Manager (LCM) with the necessary information. Para configurar o LCM, é criado um tipo especial de configuração conhecido como "metaconfiguração".To configure the LCM, you create a special type of configuration known as a "metaconfiguration". Para obter mais informações sobre como configurar o LCM, consulte Gerenciador de Configurações Local de Configuração de Estado Desejado do Windows PowerShell 4.0For more information about configuring the LCM, see Windows PowerShell 4.0 Desired State Configuration Local Configuration Manager

O script a seguir configura o LCM para efetuar o pull de configurações de um servidor chamado "PullServer":The following script configures the LCM to pull configurations from a server named "PullServer":

Configuration SimpleMetaConfigurationForPull 
{ 
    LocalConfigurationManager 
    { 
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "WebDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30; 
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"; AllowUnsecureConnection = “TRUE”}
    } 
} 
SimpleMetaConfigurationForPull -Output "."

No script, DownloadManagerCustomData passa a URL do servidor de pull e (para esse exemplo) autoriza uma conexão não segura.In the script, DownloadManagerCustomData passes the URL of the pull server and (for this example) allows an unsecured connection.

Depois de ser executado, esse script cria uma nova pasta de saída denominada SimpleMetaConfigurationForPull e coloca um arquivo MOF de metaconfiguração nela.After this script runs, it creates a new output folder called SimpleMetaConfigurationForPull and puts a metaconfiguration MOF file there.

Para aplicar a configuração, use Set-DscLocalConfigurationManager com parâmetros para ComputerName (use "localhost") e Path (o caminho até o local do arquivo localhost.meta.mof do nó de destino).To apply the configuration, use Set-DscLocalConfigurationManager with parameters for ComputerName (use “localhost”) and Path (the path to the location of the target node’s localhost.meta.mof file). Por exemplo:For example:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path . –Verbose.

ID de configuraçãoConfiguration ID

O script define a propriedade ConfigurationID do LCM para um GUID criado anteriormente para essa finalidade (você pode criar um GUID usando o cmdlet New-Guid).The script sets the ConfigurationID property of the LCM to a GUID that had been previously created for this purpose (you can create a GUID by using the New-Guid cmdlet). O ConfigurationID é usado pelo LCM para localizar a configuração apropriada no servidor de pull.The ConfigurationID is what the LCM uses to find the appropriate configuration on the pull server. O arquivo MOF de configuração no servidor de pull deve ser nomeado como ConfigurationID.mof, em que ConfigurationID é o valor da propriedade ConfigurationID do nó de destino do LCM.The configuration MOF file on the pull server must be named ConfigurationID.mof, where ConfigurationID is the value of the ConfigurationID property of the target node's LCM.

Efetuando pull de um servidor de SMBPulling from an SMB server

Se o servidor de pull é configurado como um compartilhamento de arquivos SMB em vez de como um serviço Web, especifique o DscFileDownloadManager em vez de WebDownLoadManager.If the pull server is set up as an SMB file share, rather than a web service, you specify the DscFileDownloadManager rather than the WebDownLoadManager. O DscFileDownloadManager usa uma propriedade SourcePath em vez de ServerUrl.The DscFileDownloadManager takes a SourcePath property instead of ServerUrl. O seguinte script configura o LCM para efetuar pull de configurações de um compartilhamento SMB denominado "SmbDscShare" em um servidor denominado "CONTOSO-SERVER":The following script configures the LCM to pull configurations from an SMB share named "SmbDscShare" on a server named "CONTOSO-SERVER":

Configuration SimpleMetaConfigurationForPull 
{ 
    LocalConfigurationManager 
    { 
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30; 
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    } 
} 
SimpleMetaConfigurationForPull -Output "."

Consulte TambémSee Also