Konfigurowanie klienta ściągania przy użyciu nazw konfiguracji w programie PowerShell 5.0 lub nowszym

  • Artykuł

Dotyczy: Windows PowerShell 5.0

Ważne

Serwer ściągania (Windows Feature DSC-Service) jest obsługiwanym składnikiem systemu Windows Server, jednak nie ma planów oferowania nowych funkcji lub możliwości. Chcielibyśmy wiedzieć, że nowsza wersja dsC jest teraz ogólnie dostępna, zarządzana przez funkcję Azure Policy o nazwie konfiguracja gościa. Usługa konfiguracji gościa łączy funkcje rozszerzenia DSC, Azure Automation State Configuration i najczęściej żądanych funkcji z opinii klientów. Konfiguracja gościa obejmuje również obsługę maszyn hybrydowych za pośrednictwem serwerów z obsługą usługi Arc.

Przed skonfigurowaniem klienta ściągania należy skonfigurować serwer ściągania. Chociaż ta kolejność nie jest wymagana, pomaga w rozwiązywaniu problemów i pomaga upewnić się, że rejestracja zakończyła się pomyślnie. Aby skonfigurować serwer ściągania, możesz użyć następujących przewodników:

Każdy węzeł docelowy można skonfigurować do pobierania konfiguracji, zasobów, a nawet zgłaszania stanu. W poniższych sekcjach pokazano, jak skonfigurować klienta ściągania za pomocą udziału SMB lub serwera ściągania HTTP DSC. Gdy narzędzie LCM węzła zostanie odświeżone, skontaktuje się ze skonfigurowaną lokalizacją w celu pobrania wszystkich przypisanych konfiguracji. Jeśli jakiekolwiek wymagane zasoby nie istnieją w węźle, automatycznie pobierze je ze skonfigurowanej lokalizacji. Jeśli węzeł jest skonfigurowany z serwerem raportów, zgłosi stan operacji.

Uwaga

Ten temat dotyczy programu PowerShell 5.0. Aby uzyskać informacje na temat konfigurowania klienta ściągania w programie PowerShell 4.0, zobacz Konfigurowanie klienta ściągania przy użyciu identyfikatora konfiguracji w programie PowerShell 4.0

Konfigurowanie klienta ściągania LCM

Wykonanie dowolnego z poniższych przykładów powoduje utworzenie nowego folderu wyjściowego o nazwie PullClientConfigName i umieszcza tam metakonfigurację pliku MOF. W takim przypadku plik MOF metakonfiguracji będzie miał nazwę localhost.meta.mof.

Aby zastosować konfigurację, wywołaj polecenie cmdlet Set-DscLocalConfigurationManagerz ustawioną ścieżką do lokalizacji pliku MOF metakonfiguracji. Na przykład:

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

Nazwa konfiguracji

W poniższych przykładach właściwość ConfigurationName LCM jest ustawiana na nazwę wcześniej skompilowanej konfiguracji utworzonej w tym celu. Nazwa_konfiguracji jest używana przez narzędzie LCM do znalezienia odpowiedniej konfiguracji na serwerze ściągania. Plik MOF konfiguracji na serwerze ściągania musi mieć nazwę <ConfigurationName>.mof, w tym przypadku "ClientConfig.mof". Aby uzyskać więcej informacji, zobacz Publikowanie konfiguracji na serwerze ściągania (v4/v5).

Konfigurowanie klienta ściągania w celu pobrania konfiguracji

Każdy klient musi być skonfigurowany w trybie ściągania i mieć adres URL serwera ściągania , pod którym jest przechowywana jego konfiguracja. W tym celu należy skonfigurować Configuration Manager lokalne (LCM) przy użyciu niezbędnych informacji. Aby skonfigurować LCM, należy utworzyć specjalny typ konfiguracji ozdobiony atrybutem DSCLocalConfigurationManager . Aby uzyskać więcej informacji na temat konfigurowania programu LCM, zobacz Konfigurowanie Configuration Manager lokalnego.

Poniższy skrypt konfiguruje narzędzie LCM do ściągania konfiguracji z serwera o nazwie "CONTOSO-PullSrv".

  • W skrycie blok ConfigurationRepositoryWeb definiuje serwer ściągania. Właściwość ServerURL określa punkt końcowy serwera ściągania.

  • Właściwość RegistrationKey jest kluczem udostępnionym między wszystkimi węzłami klienta dla serwera ściągania i serwera ściągania. Ta sama wartość jest przechowywana w pliku na serwerze ściągania.

    Uwaga

    Klucze rejestracji działają tylko z serwerami ściągania sieci Web . Nadal musisz użyć identyfikatora ConfigurationID z serwerem ściągania SMB . > Aby uzyskać informacje na temat konfigurowania serwera ściągania przy użyciu identyfikatora ConfigurationID, zobacz Konfigurowanie klienta ściągania przy użyciu identyfikatora konfiguracji

  • Właściwość ConfigurationNames to tablica określająca nazwy konfiguracji przeznaczonych dla węzła klienta. >Uwaga: Jeśli określisz więcej niż jedną wartość w obszarze ConfigurationNames, należy również określić bloki PartialConfiguration w konfiguracji. >Aby uzyskać informacje o konfiguracjach częściowych, zobacz PowerShell Desired State Configuration częściowych konfiguracji.

[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

Konfigurowanie klienta ściągania w celu pobrania zasobów

Jeśli określisz tylko blok ConfigurationRepositoryWeb lub ConfigurationRepositoryShare w konfiguracji LCM (jak w poprzednim przykładzie), klient ściągania będzie ściągać zasoby z tej samej lokalizacji, w której są przechowywane pliki ".mof". Możesz również określić różne lokalizacje, w których klienci mogą pobierać zasoby. Aby określić serwer zasobów, należy użyć repozytorium zasobówWeb (dla serwera ściągania internetowego) lub bloku ResourceRepositoryShare (dla serwera ściągania SMB).

W poniższym przykładzie przedstawiono metakonfigurację, która konfiguruje klienta w celu pobierania konfiguracji z serwera ściągania i zasobów z udziału SMB.

[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

Konfigurowanie klienta ściągania w celu raportowania stanu

Do konfiguracji, zasobów i raportowania można użyć jednego serwera ściągania. Raportowanie nie jest domyślnie konfigurowane dla klientów. Aby skonfigurować klienta do raportowania stanu, musisz utworzyć blok ReportRepositoryWeb . W poniższym przykładzie przedstawiono metakonfigurację, która konfiguruje klienta w celu ściągania konfiguracji i zasobów oraz wysyłania danych raportowania do pojedynczego serwera ściągania.

Uwaga

Serwer raportów nie może być udziałem SMB.

[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

Zobacz też