Lekéréses ügyfél beállítása konfigurációnevek használatával a PowerShell 5.0-s és újabb verzióiban

  • Cikk

A következőre vonatkozik: Windows PowerShell 5.0

Fontos

A Lekéréses kiszolgáló (Windows feature DSC-Service) a Windows Server egyik támogatott összetevője, de nem tervez új funkciókat vagy képességeket kínálni. Szeretnénk tudni, hogy a DSC újabb verziója már általánosan elérhető, amelyet Azure Policy nevű vendégkonfiguráció egyik funkciója felügyel. A vendégkonfigurációs szolgáltatás egyesíti a DSC-bővítmény, a Azure Automation State Configuration és az ügyfél visszajelzései által leggyakrabban kért funkciókat. A vendégkonfiguráció a hibrid gépek Arc-kompatibilis kiszolgálókon keresztüli támogatását is magában foglalja.

A lekéréses ügyfél beállítása előtt be kell állítania egy lekéréses kiszolgálót. Bár ez a rendelés nem kötelező, segít a hibaelhárításban, és segít a regisztráció sikerességének biztosításában. Lekéréses kiszolgáló beállításához használja az alábbi útmutatókat:

Minden célcsomópont konfigurálható konfigurációk, erőforrások letöltésére és állapotának jelentésére. Az alábbi szakaszok bemutatják, hogyan konfigurálhat lekéréses ügyfelet SMB-megosztással vagy HTTP DSC lekéréses kiszolgálóval. Amikor a csomópont LCM-jének frissítése történik, a rendszer megkeresi a konfigurált helyet, hogy letöltse a hozzárendelt konfigurációkat. Ha a szükséges erőforrások nem találhatók a csomóponton, az automatikusan letölti őket a konfigurált helyről. Ha a csomópont egy jelentéskészítő kiszolgálóval van konfigurálva, akkor a művelet állapotát jelenti.

Megjegyzés

Ez a témakör a PowerShell 5.0-ra vonatkozik. A lekéréses ügyfél PowerShell 4.0-s rendszerben való beállításával kapcsolatos információkért lásd: Lekéréses ügyfél beállítása konfigurációazonosítóval a PowerShell 4.0-ban

A lekéréses ügyfél LCM-jének konfigurálása

Az alábbi példák végrehajtásával létrehoz egy pullClientConfigName nevű új kimeneti mappát, és elhelyez egy metakonfigurálási MOF-fájlt. Ebben az esetben a metakonfigurálásI MOF-fájl neve localhost.meta.mof.

A konfiguráció alkalmazásához hívja meg a Set-DscLocalConfigurationManager parancsmagot, amelynek Elérési útja a metakonfigurációs MOF-fájl helyére van beállítva. Például:

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

Konfiguráció neve

Az alábbi példák az LCM ConfigurationName tulajdonságát egy korábban lefordított, erre a célra létrehozott konfiguráció nevére állítják be. Az LCM a ConfigurationName használatával keresi meg a megfelelő konfigurációt a lekéréses kiszolgálón. A lekérési kiszolgálón található konfigurációs MOF-fájlnak neve , ebben az esetben a "ClientConfig.mof" névvel <ConfigurationName>.mofkell rendelkeznie. További információ: Konfigurációk közzététele lekéréses kiszolgálón (v4/v5).

Lekéréses ügyfél beállítása konfigurációk letöltéséhez

Minden ügyfelet lekéréses módban kell konfigurálni, és meg kell adni a lekéréses kiszolgáló URL-címét, ahol a konfigurációja található. Ehhez konfigurálnia kell a Helyi Configuration Manager (LCM) a szükséges információkkal. Az LCM konfigurálásához létre kell hoznia egy speciális konfigurációtípust, amely a DSCLocalConfigurationManager attribútummal van díszítve. Az LCM konfigurálásával kapcsolatos további információkért lásd: A helyi Configuration Manager konfigurálása.

A következő szkript konfigurálja az LCM-et a "CONTOSO-PullSrv" nevű kiszolgáló konfigurációinak lekérésére.

  • A szkriptben a ConfigurationRepositoryWeb blokk határozza meg a lekéréses kiszolgálót. A ServerURL tulajdonság határozza meg a lekéréses kiszolgáló végpontjait.

  • A RegistrationKey tulajdonság egy megosztott kulcs a lekéréses kiszolgáló és a lekéréses kiszolgáló összes ügyfélcsomópontja között. Ugyanez az érték a lekérési kiszolgálón található fájlban van tárolva.

    Megjegyzés

    A regisztrációs kulcsok csak webes lekéréses kiszolgálókon működnek. A ConfigurationID-t továbbra is SMB lekéréses kiszolgálóval kell használnia. > A lekéréses kiszolgáló ConfigurationID használatával történő konfigurálásával kapcsolatos információkért lásd: Lekéréses ügyfél beállítása konfigurációazonosító használatával

  • A ConfigurationNames tulajdonság egy tömb, amely az ügyfélcsomóponthoz szánt konfigurációk nevét adja meg. >Megjegyzés: Ha egynél több értéket ad meg a ConfigurationNames mezőben, a konfigurációban részleges konfigurációs blokkokat is meg kell adnia. >A részleges konfigurációkkal kapcsolatos információkért lásd: PowerShell Desired State Configuration részleges konfigurációk.

[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

Lekéréses ügyfél beállítása erőforrások letöltéséhez

Ha csak egy ConfigurationRepositoryWeb vagy ConfigurationRepositoryShare blokkot ad meg az LCM-konfigurációban (az előző példához hasonlóan), a lekéréses ügyfél ugyanabból a helyről fogja lekérni az erőforrásokat, ahol a ".mof" fájlokat tárolja. Különböző helyeket is megadhat, ahol az ügyfelek letölthetik az erőforrásokat. Erőforrás-kiszolgáló megadásához használjon ResourceRepositoryWebet (webes lekéréses kiszolgálóhoz) vagy ResourceRepositoryShare blokkot (SMB lekéréses kiszolgálóhoz).

Az alábbi példa egy metakonfigurációt mutat be, amely beállítja az ügyfelet, hogy konfigurációkat töltsön le egy lekéréses kiszolgálóról, és erőforrásokat egy SMB-megosztásból.

[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

Lekéréses ügyfél beállítása az állapot jelentéséhez

Egyetlen lekéréses kiszolgálót használhat konfigurációkhoz, erőforrásokhoz és jelentésekhez. A jelentéskészítés alapértelmezés szerint nincs konfigurálva az ügyfelek számára. Az ügyfél jelentési állapotra való konfigurálásához létre kell hoznia egy ReportRepositoryWeb blokkot. Az alábbi példa egy metakonfigurációt mutat be, amely beállít egy ügyfelet a konfigurációk és erőforrások lekérésére, valamint jelentéskészítési adatok egyetlen lekéréses kiszolgálóra való küldésére.

Megjegyzés

A jelentéskészítő kiszolgáló nem lehet SMB-megosztás.

[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

Lásd még: