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

  • Cikk

Érintett kiadások: 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 egy ú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 funkcióit, a Azure Automation State Configuration és a leggyakrabban kért funkciókat az ügyfelek visszajelzései alapján. 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 az alábbi útmutatókat használhatja:

Minden célcsomópont konfigurálható konfigurációk, erőforrások letöltésére, sőt állapotának jelentésére is. 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 a konfigurált helyre lép, hogy letöltse a hozzárendelt konfigurációkat. Ha a szükséges erőforrások nem léteznek a csomóponton, 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 jelentést készít a művelet állapotáról.

Megjegyzés

Ez a témakör a PowerShell 5.0-s verzió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 a PowerShell 4.0 konfigurációs azonosítójával

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 pullClientConfigID 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 .\PullClientConfigId –Verbose.

Konfigurációs azonosító

Az alábbi példák az LCM ConfigurationID tulajdonságát egy korábban erre a célra létrehozott GUID-ra állítja. Az LCM a ConfigurationID használatával keresi meg a megfelelő konfigurációt a lekérési kiszolgálón. A lekérési kiszolgáló konfigurációs MOF-fájljának neve ConfigurationID.mof, ahol a ConfigurationID a célcsomópont LCM-jének ConfigurationID tulajdonságának értéke. További információ: Konfigurációk közzététele lekéréses kiszolgálón (v4/v5).

Az alábbi példában vagy a New-Guid parancsmaggal hozhat létre véletlenszerű guid azonosítót.

[System.Guid]::NewGuid()

A GUID-azonosítók környezetbeli használatáról további információt a Guidok tervezése című témakörben talál.

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. További információ az LCM konfigurálásáról: A helyi Configuration Manager konfigurálása.

HTTP DSC lekéréses kiszolgáló

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

[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

A szkriptben a ConfigurationRepositoryWeb blokk határozza meg a lekérési kiszolgálót. A ServerUrl megadja a DSC-lekérés URL-címét

SMB-megosztás

A következő szkript úgy konfigurálja az LCM-et, hogy lekérje a konfigurációkat az SMB-megosztásból \\SMBPullServer\Pull.

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

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

A szkriptben a ConfigurationRepositoryShare blokk határozza meg a lekéréses kiszolgálót, amely ebben az esetben csak egy SMB-megosztás.

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

Ha csak a ConfigurationRepositoryWeb vagy ConfigurationRepositoryShare blokkot adja meg az LCM-konfigurációban (az előző példákhoz hasonlóan), a lekéréses ügyfél ugyanabból a helyről fogja lekérni az erőforrásokat, ahonnan lekéri a konfigurációit. Az erőforrásokhoz külön helyeket is megadhat. Ha egy erőforrás helyét külön kiszolgálóként szeretné megadni, használja a ResourceRepositoryWeb blokkot. Az erőforrás helyének SMB-megosztásként való megadásához használja a ResourceRepositoryShare blokkot.

Megjegyzés

A ConfigurationRepositoryWeb és a ResourceRepositoryShare vagy a ConfigurationRepositoryShare és a ResourceRepositoryWeb kombinálható. Erre az alábbiakban nem mutatunk be példákat.

HTTP DSC lekéréses kiszolgáló

Az alábbi metakonfiguráció konfigurálja a lekéréses ügyfelet, hogy a KONFIGURÁCIÓkat a CONTOSO-PullSrvből és annak erőforrásaiból a CONTOSO-ResourceSrvből kérje le.

[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

SMB-megosztás

Az alábbi példa egy metakonfigurációt mutat be, amely beállít egy ügyfelet, hogy konfigurációkat kérjen le az SMB-megosztásból \\SMBPullServer\Configurations, és erőforrásokat az SMB-megosztásból \\SMBPullServer\Resources.

[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

Erőforrások automatikus letöltése leküldéses módban

A PowerShell 5.0-tól kezdve a lekéréses ügyfelek akkor is letölthetik a modulokat egy SMB-megosztásból, ha leküldéses módra vannak konfigurálva. Ez különösen akkor hasznos, ha nem szeretne lekéréses kiszolgálót beállítani. A ResourceRepositoryShare blokk configurationRepositoryShare megadása nélkül használható. Az alábbi példa egy metakonfigurálást mutat be, amely beállítja az ügyfelet, hogy erőforrásokat kérjen le egy SMB-megosztásból \\SMBPullServer\Resources. Ha a Node PUSHED típusú konfigurációt kap, automatikusan letölti a szükséges erőforrásokat a megadott megosztásból.

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

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

Lekéréses ügyfél beállítása állapotjelentéshez

Alapértelmezés szerint a csomópontok nem küldenek jelentéseket konfigurált lekéréses kiszolgálónak. Egyetlen lekéréses kiszolgálót használhat konfigurációkhoz, erőforrásokhoz és jelentésekhez, de a jelentéskészítés beállításához létre kell hoznia egy ReportRepositoryWeb blokkot.

HTTP DSC lekéréses kiszolgáló

Az alábbi példa egy metakonfigurációt mutat be, amely beállít egy ügyfelet konfigurációk és erőforrások lekéréséhez, valamint jelentéskészítési adatok egyetlen lekérési kiszolgálóra való küldéséhez.

[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

Jelentéskészítő kiszolgáló megadásához használja a ReportRepositoryWeb blokkot. A jelentéskészítő kiszolgáló nem lehet SMB-kiszolgáló. Az alábbi metakonfiguráció úgy konfigurálja a lekéréses ügyfelet, hogy lekérje a konfigurációit a CONTOSO-PullSrvből és erőforrásaiból a CONTOSO-ResourceSrv adatbázisból, és állapotjelentéseket küldjön a CONTOSO-ReportSrvnek:

[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

SMB-megosztás

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

Következő lépések

A lekéréses ügyfél konfigurálása után a következő útmutatók segítségével hajthatja végre a következő lépéseket:

Lásd még: