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

Artykuł
06/22/2023

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

Udostępnij za pośrednictwem