Nastavení klienta vyžádané replikace pomocí ID konfigurace v PowerShellu 5.0 a novějších verzích

Č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

Provedením některého z následujících příkladů se vytvoří nová výstupní složka s názvem PullClientConfigID 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 .\PullClientConfigId –Verbose.

ID konfigurace

Následující příklady nastaví vlastnost ConfigurationID LCM na identifikátor GUID , který byl dříve vytvořen pro tento účel. Id konfigurace 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 ConfigurationID.mof, kde ConfigurationID je hodnota vlastnosti ConfigurationID cílového uzlu LCM. Další informace najdete v tématu Publikování konfigurací na server vyžádané replikace (v4/v5).

Náhodný identifikátor GUID můžete vytvořit pomocí následujícího příkladu nebo pomocí rutiny New-Guid .

[System.Guid]::NewGuid()

Další informace o používání identifikátorů GUID ve vašem prostředí najdete v tématu Plánování identifikátorů GUID.

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.

Server vyžádané replikace HTTP DSC

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

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }
    }
}
PullClientConfigID

Blok ConfigurationRepositoryWeb ve skriptu definuje server vyžádané replikace. ServerUrl určuje adresu URL vyžádané replikace DSC.

Následující skript nakonfiguruje LCM tak, aby načte konfigurace ze sdílené složky \\SMBPullServer\PullSMB .

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Pull'
        }
    }
}
PullClientConfigID

Blok ConfigurationRepositoryShare ve skriptu definuje server vyžádané replikace, což je v tomto případě pouze sdílená složka SMB.

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ích příkladech), klient vyžádané replikace načte prostředky ze stejného umístění, které načítá své konfigurace. Můžete také zadat samostatná umístění pro prostředky. Pokud chcete určit umístění prostředku jako samostatný server, použijte blok ResourceRepositoryWeb . Pokud chcete určit umístění prostředku jako sdílenou složku SMB, použijte blok ResourceRepositoryShare .

Poznámka

Můžete kombinovat ConfigurationRepositoryWeb s ResourceRepositoryShare nebo ConfigurationRepositoryShare s ResourceRepositoryWeb. Příklady tohoto příkladu nejsou uvedené níže.

Server vyžádané replikace HTTP DSC

Následující metakonfigurace nakonfiguruje klienta vyžádané replikace tak, aby získal jeho konfigurace z CONTOSO-PullSrv a jeho prostředků z CONTOSO-ResourceSrv.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'

        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

Následující příklad ukazuje metakonfiguraci, která nastaví klienta na vyžádání konfigurací ze sdílené složky \\SMBPullServer\ConfigurationsSMB a prostředků ze sdílené složky \\SMBPullServer\ResourcesSMB .

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryShare SMBPullServer
        {
            SourcePath = '\\SMBPullServer\Configurations'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

Automatické stahování prostředků v režimu nabízení

Od PowerShellu 5.0 můžou klienti vyžádané replikace stahovat moduly ze sdílené složky SMB, i když jsou nakonfigurovaní pro režim nabízení . To je užitečné zejména ve scénářích, kdy nechcete nastavit server vyžádané replikace. Blok ResourceRepositoryShare lze použít bez zadání ConfigurationRepositoryShare. Následující příklad ukazuje metakonfiguraci, která nastaví klienta tak, aby naháněl prostředky ze sdílené složky \\SMBPullServer\ResourcesSMB . Když je uzel PUSHED konfigurace, automaticky stáhne všechny požadované prostředky ze zadané sdílené složky.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
        }

        ResourceRepositoryShare SMBResourceServer
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigID

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

Uzly ve výchozím nastavení neodesílají sestavy na nakonfigurovaný server vyžádané replikace. Pro konfigurace, prostředky a vytváření sestav můžete použít jeden server vyžádané replikace, ale pro nastavení vytváření sestav musíte vytvořit blok ReportRepositoryWeb .

Server vyžádané replikace HTTP DSC

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.

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

Chcete-li určit server sestav, použijte blok ReportRepositoryWeb . Server sestav nemůže být serverem SMB. Následující metakonfigurace nakonfiguruje klienta vyžádané replikace tak, aby získal konfiguraci z CONTOSO-PullSrv a jeho prostředků z CONTOSO-ResourceSrv a aby do contoso-ReportSrv odesílal zprávy o stavu:

[DSCLocalConfigurationManager()]
configuration PullClientConfigID
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
        }

        ResourceRepositoryWeb CONTOSO-ResourceSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }

        ReportServerWeb CONTOSO-ReportSrv
        {
            ServerURL = 'https://CONTOSO-REsourceSrv:8080/PSDSCPullServer.svc'
        }
    }
}
PullClientConfigID

Server sestav nemůže být sdílenou složkou SMB.

Další kroky

Po nakonfigurování klienta vyžádané replikace můžete k provedení dalších kroků použít následující příručky:

Viz také

Nastavení klienta vyžádané replikace s názvy konfigurací

Sdílet prostřednictvím

Nastavení klienta vyžádané replikace pomocí ID konfigurace v PowerShellu 5.0 a novějších verzích

Konfigurace LCM klienta vyžádané replikace

ID konfigurace

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

Server vyžádané replikace HTTP DSC

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

Server vyžádané replikace HTTP DSC

Automatické stahování prostředků v režimu nabízení

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

Server vyžádané replikace HTTP DSC

Další kroky

Viz také

Další materiály

Sdílet prostřednictvím

Nastavení klienta vyžádané replikace pomocí ID konfigurace v PowerShellu 5.0 a novějších verzích

Konfigurace LCM klienta vyžádané replikace

ID konfigurace

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

Server vyžádané replikace HTTP DSC

Sdílená složka SMB

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

Server vyžádané replikace HTTP DSC

Sdílená složka SMB

Automatické stahování prostředků v režimu nabízení

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

Server vyžádané replikace HTTP DSC

Sdílená složka SMB

Další kroky

Viz také

Další materiály