Nastavení klienta vyžádané replikace pomocí konfiguračních názvů v PowerShellu 5.0 a novějším

Článek
10/17/2023

Platí pro: Windows PowerShell 5.0

Důležité

Server vyžádané replikace ( Windows Feature DSC-Service) je podporovaná součást Systému Windows Server, ale neplánuje se nabízet nové funkce nebo možnosti. rádi bychom, abyste věděli, že novější verze DSC je nyní obecně dostupná, spravovaná funkcí Azure Policy pojmenovanou host configuration. Služba konfigurace hosta kombinuje funkce rozšíření DSC, Azure Automation State Configuration a nejčastěji požadované funkce podle zpětné vazby od zákazníků. Konfigurace hosta zahrnuje také podporu hybridních počítačů prostřednictvím serverů s podporou Arc.

Před nastavením klienta vyžádané replikace byste měli nastavit server vyžádané replikace. I když tato objednávka není povinná, pomůže vám s řešením potíží a pomůže vám zajistit, aby registrace proběhla úspěšně. K nastavení serveru vyžádané replikace můžete použít následující příručky:

Každý cílový uzel je možné nakonfigurovat tak, aby stahoval konfigurace, prostředky a dokonce i hlásil svůj stav. V následujících částech se dozvíte, jak nakonfigurovat klienta vyžádané replikace se sdílenou složkou SMB nebo serverem vyžádané replikace HTTP DSC. Když se aktualizuje LCM uzlu, bude kontaktovat nakonfigurované umístění a stáhnout všechny přiřazené konfigurace. Pokud v uzlu neexistují žádné požadované prostředky, automaticky je stáhne z nakonfigurovaného umístění. Pokud je uzel nakonfigurovaný se serverem sestav, bude hlásit stav operace.

Poznámka

Toto téma se týká PowerShellu 5.0. Informace o nastavení klienta vyžádané replikace v PowerShellu 4.0 najdete v tématu Nastavení klienta vyžádané replikace pomocí ID konfigurace v PowerShellu 4.0.

Konfigurace LCM klienta vyžádané replikace

Spuštěním některého z následujících příkladů se vytvoří nová výstupní složka s názvem PullClientConfigName a umístí se do ní soubor MOF metakonfigurace. V tomto případě bude mít metakonfigurační soubor MOF název localhost.meta.mof.

Chcete-li použít konfiguraci, zavolejte rutinu Set-DscLocalConfigurationManager s cestou nastavenou na umístění souboru MOF metakonfigurace. Příklad:

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

Název konfigurace

Následující příklady nastaví vlastnost ConfigurationName LCM na název dříve zkompilované konfigurace vytvořené pro tento účel. ConfigurationName je to, co LCM používá k vyhledání odpovídající konfigurace na serveru vyžádané replikace. Konfigurační soubor MOF na serveru vyžádané replikace musí mít název <ConfigurationName>.mof, v tomto případě "ClientConfig.mof". Další informace najdete v tématu Publikování konfigurací na server vyžádané replikace (v4/v5).

Nastavení klienta vyžádané replikace pro stahování konfigurací

Každý klient musí být nakonfigurovaný v režimu vyžádání a musí mít adresu URL serveru vyžádané replikace, kde je uložena jeho konfigurace. K tomu je potřeba nakonfigurovat místní Configuration Manager (LCM) s potřebnými informacemi. Chcete-li nakonfigurovat LCM, vytvoříte speciální typ konfigurace, zdobený atributem DSCLocalConfigurationManager . Další informace o konfiguraci LCM najdete v tématu Konfigurace místního Configuration Manager.

Následující skript nakonfiguruje LCM tak, aby naháněl konfigurace ze serveru s názvem "CONTOSO-PullSrv".

Blok ConfigurationRepositoryWeb ve skriptu definuje server vyžádané replikace. Vlastnost ServerURL určuje koncový bod serveru vyžádané replikace.
Vlastnost RegistrationKey je sdílený klíč mezi všemi klientskými uzly serveru vyžádané replikace a serveru vyžádané replikace. Stejná hodnota je uložena v souboru na serveru vyžádané replikace.

Poznámka

Registrační klíče fungují jenom se servery vyžádané replikace. Stále musíte používat ConfigurationID se serverem vyžádané replikace SMB . >Informace o konfiguraci serveru vyžádané replikace pomocí Id konfigurace najdete v tématu Nastavení klienta vyžádané replikace pomocí ID konfigurace.
Vlastnost ConfigurationNames je pole, které určuje názvy konfigurací určených pro klientský uzel. >Poznámka: Pokud zadáte více než jednu hodnotu v ConfigurationNames, musíte také zadat částečnékonfigurace bloky v konfiguraci. >Informace o částečných konfiguracích najdete v tématu PowerShell Desired State Configuration částečné konfigurace.

[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

Nastavení klienta vyžádané replikace pro stahování prostředků

Pokud v konfiguraci LCM zadáte pouze blok ConfigurationRepositoryWeb nebo ConfigurationRepositoryShare (jako v předchozím příkladu), klient vyžádané replikace načte prostředky ze stejného umístění, kde jsou uloženy vaše soubory ".mof". Můžete také zadat různá umístění, kam mohou klienti stahovat prostředky. Pokud chcete určit server prostředků, použijte buď ResourceRepositoryWeb (pro server webového vyžádání), nebo blok ResourceRepositoryShare (pro server vyžádané replikace SMB).

Následující příklad ukazuje metakonfiguraci, která nastaví klienta pro stahování konfigurací ze serveru vyžádané replikace a prostředků ze sdílené složky 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

Nastavení klienta vyžádané replikace pro hlášení stavu

Pro konfigurace, prostředky a vytváření sestav můžete použít jeden server vyžádané replikace. Generování sestav není ve výchozím nastavení nakonfigurované pro klienty. Pokud chcete nakonfigurovat klienta pro hlášení stavu, musíte vytvořit blok ReportRepositoryWeb . Následující příklad ukazuje metakonfiguraci, která nastaví klienta na vyžádání konfigurací a prostředků a odesílání dat sestav na jeden server vyžádané replikace.

Poznámka

Server sestav nemůže být sdílenou složkou 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

Sdílet prostřednictvím