Konfigurera en pull-klient med hjälp av konfigurationsnamn i PowerShell 5.0 och senare

Gäller för: Windows PowerShell 5.0

Innan du konfigurerar en pull-klient bör du konfigurera en pull-server. Även om den här beställningen inte krävs hjälper den till med felsökning och hjälper dig att se till att registreringen lyckades. Om du vill konfigurera en pull-server kan du använda följande guider:

• Konfigurera en DSC SMB Pull-server
• Konfigurera en DSC HTTP-pullserver

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-pullserver. När nodens LCM uppdateras kommer den att kontakta den konfigurerade platsen för att ladda ner alla tilldelade konfigurationer. Om det inte finns några nödvändiga resurser på noden laddas de automatiskt ned från den konfigurerade platsen. Om noden är konfigurerad med en rapportserver kommer den sedan att rapportera status för åtgärden.

Konfigurera LCM för pull-klienten

Om du kör något av exemplen nedan skapas en ny utdatamapp med namnet PullClientConfigName 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 metakonfigurations-MOF-filen. Till exempel:

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

Konfigurationsnamn

Exemplen nedan anger egenskapen ConfigurationName för LCM till namnet på en tidigare kompilerad konfiguration som skapats för detta ändamål. ConfigurationName är det som LCM använder för att hitta lämplig konfiguration på pull-servern. MOF-konfigurationsfilen på pull-servern måste ha namnet <ConfigurationName>.mof, i det här fallet "ClientConfig.mof". Mer information finns i Publicera konfigurationer till en pull-server (v4/v5).

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

Varje klient måste konfigureras i pull-läge och ges den pull-server-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 som är dekorerad med attributet DSCLocalConfigurationManager . Mer information om hur du konfigurerar LCM finns i Konfigurera den lokala Configuration Manager.

Följande skript konfigurerar LCM för att hämta konfigurationer från en server med namnet "CONTOSO-PullSrv".

• I skriptet definierar ConfigurationRepositoryWeb-blocket pull-servern. Egenskapen ServerURL anger slutpunkten för pull-servern.

• Egenskapen RegistrationKey är en delad nyckel mellan alla klientnoder för en pull-server och den pull-servern. Samma värde lagras i en fil på pull-servern.

  Anmärkning

  Registreringsnycklar fungerar bara med webbhämtningsservrar . Du måste fortfarande använda ConfigurationID med en SMB-pullserver . > Information om hur du konfigurerar en pull-server med hjälp av ConfigurationID finns i Konfigurera en pull-klient med hjälp av konfigurations-ID

• Egenskapen ConfigurationNames är en matris som anger namnen på de konfigurationer som är avsedda för klientnoden. > Not: Om du anger fler än ett värde i ConfigurationNames måste du också ange PartialConfiguration block i konfigurationen. >Information om partiella konfigurationer finns i PowerShell Desired State Configuration partiella konfigurationer.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }
        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '140a952b-b9d6-406b-b416-e0f759c9c0e4'
            ConfigurationNames = @('ClientConfig')
        }
    }
}
PullClientConfigNames

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

Om du bara anger ett ConfigurationRepositoryWeb- eller ConfigurationRepositoryShare-block i LCM-konfigurationen (som i föregående exempel) hämtar pull-klienten resurser från samma plats där dina ".mof"-filer lagras. Du kan också ange olika platser där klienter kan ladda ned resurser. Om du vill ange en resursserver använder du antingen en ResourceRepositoryWeb (för en webbpull-server) eller ett ResourceRepositoryShare-block (för en SMB-pullserver).

I följande exempel visas en metakonfiguration som konfigurerar en klient för att ladda ned konfigurationer från en pull-server och resurser från en SMB-resurs.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ResourceRepositoryShare SMBResources
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigNames

Konfigurera en pull-klient för att rapportera status

Du kan använda en enda pull-server för konfigurationer, resurser och rapportering. Rapportering är inte konfigurerad för klienter som standard. Om du vill konfigurera en klient att rapportera status måste du skapa ett ReportRepositoryWeb-block . I följande exempel visas en metakonfiguration som konfigurerar en klient för att hämta konfigurationer och resurser och skicka rapportdata till en enda pull-server.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }
    }
}
PullClientConfigNames

Se även

• Konfigurera en pull-klient med konfigurations-ID
• Konfigurera en DSC-webbhämtningsserver