Konfigurera en pull-klient med hjälp av konfigurations-ID:t i PowerShell 4.0

  • Artikel

Gäller för: Windows PowerShell 4.0, Windows PowerShell 5.0

Viktigt

Pull Server (Windows Feature DSC-Service) är en komponent som stöds i Windows Server, men det finns inga planer på att erbjuda nya funktioner. Vi vill att du ska veta att en nyare version av DSC nu är allmänt tillgänglig, som hanteras av en funktion i Azure Policy med namnet gästkonfiguration. Gästkonfigurationstjänsten kombinerar funktioner i DSC-tillägget, Azure Automation State Configuration och de vanligaste funktionerna från kundfeedback. Gästkonfigurationen omfattar även stöd för hybriddatorer via Arc-aktiverade servrar.

Innan du konfigurerar en hämtningsklient bör du konfigurera en hämtningsserver. Även om den här ordningen inte krävs hjälper den till med felsökningen och hjälper dig att säkerställa att registreringen lyckades. Om du vill konfigurera en hämtningsserver kan du använda följande guider:

Varje målnod kan konfigureras för att ladda ned konfigurationer, resurser och till och med rapportera dess status. Avsnitten nedan visar hur du konfigurerar en pull-klient med en SMB-resurs eller HTTP DSC-hämtningsserver. När nodens LCM uppdateras kontaktar den den konfigurerade platsen för att ladda ned eventuella tilldelade konfigurationer. Om det inte finns några nödvändiga resurser på noden hämtas de automatiskt från den konfigurerade platsen. Om noden har konfigurerats med en rapportserver rapporterar den åtgärdens status.

Konfigurera pull-klientens LCM

Om du kör något av exemplen nedan skapas en ny utdatamapp med namnet PullClientConfigID och en MOF-fil för metakonfiguration placeras där. I det här fallet får MOF-filen för metakonfiguration namnet localhost.meta.mof.

Om du vill tillämpa konfigurationen anropar du cmdleten Set-DscLocalConfigurationManager med sökvägen inställd på platsen för MOF-filen för metakonfiguration. Exempel:

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

Konfigurations-ID

I exemplen nedan anges egenskapen ConfigurationID för LCM till ett GUID som tidigare har skapats för detta ändamål. ConfigurationID är det som LCM använder för att hitta rätt konfiguration på hämtningsservern. MOF-konfigurationsfilen på hämtningsservern måste ha namnet ConfigurationID.mof, där ConfigurationID är värdet för egenskapen ConfigurationID för målnodens LCM. Mer information finns i Publicera konfigurationer till en hämtningsserver (v4/v5).

Du kan skapa ett slumpmässigt GUID med hjälp av exemplet nedan.

[System.Guid]::NewGuid()

Konfigurera en pull-klient för att ladda ned konfigurationer

Varje klient måste konfigureras i pull-läge och med tanke på pull-serverns URL där dess konfiguration lagras. För att göra detta måste du konfigurera den lokala Configuration Manager (LCM) med nödvändig information. Om du vill konfigurera LCM skapar du en särskild typ av konfiguration med ett LocalConfigurationManager-block . Mer information om hur du konfigurerar LCM finns i Konfigurera den lokala Configuration Manager.

HTTP DSC-hämtningsserver

Om hämtningsservern har konfigurerats som en webbtjänst ställer du in DownloadManagerName på WebDownloadManager. WebDownloadManager kräver att du anger en ServerUrl till nyckeln DownloadManagerCustomData. Du kan också ange ett värde för AllowUnsecureConnection, som i exemplet nedan. Följande skript konfigurerar LCM för att hämta konfigurationer från en server med namnet "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-resurs

Om hämtningsservern är konfigurerad som en SMB-filresurs i stället för en webbtjänst ställer du in DownloadManagerName på DscFileDownloadManager i stället för WebDownLoadManager. DscFileDownloadManager kräver att du anger en SourcePath-egenskap i DownloadManagerCustomData. Följande skript konfigurerar LCM för att hämta konfigurationer från en SMB-resurs med namnet "SmbDscShare" på en server med namnet "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 "."

Nästa steg

När pull-klienten har konfigurerats kan du använda följande guider för att utföra nästa steg:

Se även