Konfigurowanie klienta ściągania przy użyciu identyfikatorów konfiguracji w programie PowerShell 4.0

  • Artykuł

Dotyczy: Windows PowerShell 4.0, 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 rozszerzenia 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ż to zamówienie nie jest wymagane, 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 raportowania stanu. W poniższych sekcjach pokazano, jak skonfigurować klienta ściągania za pomocą udziału SMB lub serwera ściągania HTTP DSC. Po odświeżeniu menedżera LCM węzła zostanie nawiązany dostęp do skonfigurowanej lokalizacji 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 przy użyciu serwera raportów, będzie zgłaszać stan operacji.

Konfigurowanie klienta ściągania LCM

Wykonanie dowolnego z poniższych przykładów powoduje utworzenie nowego folderu wyjściowego o nazwie PullClientConfigID i umieszcza tam plik MOF metakonfiguracji. W takim przypadku plik MOF metakonfiguracji będzie mieć 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 .\PullClientConfigId –Verbose.

Identyfikator konfiguracji

W poniższych przykładach właściwość ConfigurationID zdarzenia LCM została ustawiona na identyfikator GUID , który został wcześniej utworzony w tym celu. Identyfikator konfiguracji jest używany przez narzędzie LCM do znalezienia odpowiedniej konfiguracji na serwerze ściągania. Plik MOF konfiguracji na serwerze ściągania musi mieć nazwę ConfigurationID.mof, gdzie ConfigurationID jest wartością właściwości ConfigurationID węzła docelowego LCM. Aby uzyskać więcej informacji, zobacz Publikowanie konfiguracji na serwerze ściągania (v4/v5).

Możesz utworzyć losowy identyfikator GUID , korzystając z poniższego przykładu.

[System.Guid]::NewGuid()

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, w którym jest przechowywana jego konfiguracja. W tym celu należy skonfigurować Configuration Manager lokalne (LCM) przy użyciu niezbędnych informacji. Aby skonfigurować narzędzie LCM, należy utworzyć specjalny typ konfiguracji z blokiem LocalConfigurationManager . Aby uzyskać więcej informacji na temat konfigurowania programu LCM, zobacz Konfigurowanie Configuration Manager lokalnego.

Serwer ściągania HTTP DSC

Jeśli serwer ściągania jest skonfigurowany jako usługa internetowa, należy ustawić parametr DownloadManagerName na WebDownloadManager. Składnik WebDownloadManager wymaga określenia wartości ServerUrl do klucza DownloadManagerCustomData . Możesz również określić wartość parametru AllowUnsecureConnection, jak w poniższym przykładzie. Poniższy skrypt konfiguruje narzędzie LCM do ściągania konfiguracji z serwera o nazwie "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 "."

Udział SMB

Jeśli serwer ściągania jest skonfigurowany jako udział plików SMB, a nie usługa internetowa, należy ustawić parametr DownloadManagerName na DscFileDownloadManager zamiast WebDownLoadManager. Właściwość DscFileDownloadManager wymaga określenia właściwości SourcePath w elemecie DownloadManagerCustomData. Poniższy skrypt konfiguruje narzędzie LCM do ściągania konfiguracji z udziału SMB o nazwie "SmbDscShare" na serwerze o nazwie "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 "."

Następne kroki

Po skonfigurowaniu klienta ściągania możesz użyć następujących przewodników, aby wykonać następne kroki:

Zobacz też