Delen via

Een pull-client instellen met behulp van configuratie-id's in PowerShell 4.0

  • Artikel

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0

Belangrijk

De pull-server (Windows Feature DSC-Service) is een ondersteund onderdeel van Windows Server, maar er zijn geen plannen om nieuwe functies of mogelijkheden aan te bieden. We willen graag dat u weet dat een nieuwere versie van DSC nu algemeen beschikbaar is, beheerd door een functie van Azure Policy met de naam gastconfiguratie. De gastconfiguratieservice combineert functies van DSC-extensie, Azure Automation State Configuration en de meest gevraagde functies uit feedback van klanten. Gastconfiguratie omvat ook ondersteuning voor hybride machines via servers met Arc.

Voordat u een pull-client instelt, moet u een pull-server instellen. Hoewel deze bestelling niet vereist is, helpt het bij het oplossen van problemen en zorgt u ervoor dat de registratie is geslaagd. Als u een pull-server wilt instellen, kunt u de volgende handleidingen gebruiken:

Elk doelknooppunt kan worden geconfigureerd om configuraties en resources te downloaden en zelfs de status ervan te rapporteren. In de onderstaande secties ziet u hoe u een pull-client configureert met een SMB-share of HTTP DSC-pullserver. Wanneer de LCM van het knooppunt wordt vernieuwd, neemt het contact op met de geconfigureerde locatie om toegewezen configuraties te downloaden. Als er geen vereiste resources op het knooppunt bestaan, worden deze automatisch gedownload vanaf de geconfigureerde locatie. Als het knooppunt is geconfigureerd met een rapportserver, wordt de status van de bewerking gerapporteerd.

De LCM van de pull-client configureren

Als u een van de onderstaande voorbeelden uitvoert, wordt een nieuwe uitvoermap met de naam PullClientConfigID gemaakt en wordt daar een MOF-bestand voor metaconfiguratie geplaatst. In dit geval krijgt het MOF-bestand van de metaconfiguratie de naam localhost.meta.mof.

Als u de configuratie wilt toepassen, roept u de cmdlet Set-DscLocalConfigurationManager aan, waarbij het pad is ingesteld op de locatie van het metaconfiguration MOF-bestand. Bijvoorbeeld:

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

Configuratie-id

In de onderstaande voorbeelden wordt de eigenschap ConfigurationID van de LCM ingesteld op een GUID die eerder voor dit doel is gemaakt. De ConfigurationID is wat de LCM gebruikt om de juiste configuratie op de pull-server te vinden. Het configuratie-MOF-bestand op de pull-server moet de naam ConfigurationID.mofhebben, waarbij ConfigurationID de waarde is van de eigenschap ConfigurationID van de LCM van het doelknooppunt. Zie Configuraties publiceren naar een pull-server (v4/v5) voor meer informatie.

U kunt een willekeurige GUID maken met behulp van het onderstaande voorbeeld.

[System.Guid]::NewGuid()

Een pull-client instellen om configuraties te downloaden

Elke client moet worden geconfigureerd in de pull-modus en de URL van de pull-server krijgen waar de configuratie wordt opgeslagen. Hiervoor moet u de Local Configuration Manager (LCM) configureren met de benodigde informatie. Als u de LCM wilt configureren, maakt u een speciaal type configuratie, met een LocalConfigurationManager-blok . Zie De lokale Configuration Manager configureren voor meer informatie over het configureren van de LCM.

HTTP DSC-pullserver

Als de pull-server is ingesteld als een webservice, stelt u DownloadManagerName in op WebDownloadManager. Voor De WebDownloadManager moet u een ServerUrl opgeven voor de sleutel DownloadManagerCustomData . U kunt ook een waarde opgeven voor AllowUnsecureConnection, zoals in het onderstaande voorbeeld. Met het volgende script wordt de LCM geconfigureerd voor het ophalen van configuraties van een server met de naam 'PullServer'.

Configuration PullClientConfigId
{
    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"
        }
    }
}
PullClientConfigId -Output "."

SMB-share

Als de pull-server is ingesteld als een SMB-bestandsshare in plaats van een webservice, stelt u DownloadManagerName in op DscFileDownloadManager in plaats van de WebDownLoadManager. Voor DscFileDownloadManager moet u een SourcePath-eigenschap opgeven in DownloadManagerCustomData. Met het volgende script configureert u de LCM om configuraties op te halen uit een SMB-share met de naam 'SmbDscShare' op een server met de naam 'CONTOSO-SERVER'.

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

Volgende stappen

Zodra de pull-client is geconfigureerd, kunt u de volgende handleidingen gebruiken om de volgende stappen uit te voeren:

Zie ook