مشاركة عبر

إعداد عميل السحب باستخدام أسماء التكوين في PowerShell 5.0 والإصدارات الأحدث

  • مقالة

ينطبق على: Windows PowerShell 5.0

هام

خادم السحب (Windows Feature DSC-Service) هو مكون مدعوم من Windows Server ولكن لا توجد خطط لتقديم ميزات أو قدرات جديدة. نود أن تعرف أن إصدارا أحدث من DSC متاح الآن بشكل عام، تتم إدارته بواسطة ميزة Azure Policy المسماة تكوين الضيف. تجمع خدمة تكوين الضيف ميزات ملحق DSC وAzure Automation State Configuration والميزات الأكثر شيوعاً المطلوبة من ملاحظات العملاء. يتضمن تكوين الضيف أيضاً دعم الجهاز المختلط من خلال الخوادم الممكنة بواسطة Arc.

قبل إعداد عميل سحب، يجب عليك إعداد خادم سحب. على الرغم من أن هذا الطلب غير مطلوب، إلا أنه يساعد في استكشاف الأخطاء وإصلاحها، ويساعدك على ضمان نجاح التسجيل. لإعداد خادم سحب، يمكنك استخدام الدلائل التالية:

يمكن تكوين كل عقدة مستهدفة لتنزيل التكوينات والموارد وحتى الإبلاغ عن حالتها. توضح لك الأقسام أدناه كيفية تكوين عميل سحب مع مشاركة SMB أو خادم سحب HTTP DSC. عند تحديث LCM للعقدة، سيتم الوصول إلى الموقع الذي تم تكوينه لتنزيل أي تكوينات معينة. إذا لم تكن هناك أي موارد مطلوبة على العقدة، فسيتم تنزيلها تلقائيا من الموقع الذي تم تكوينه. إذا تم تكوين العقدة باستخدام خادم التقارير، فستبلغ بعد ذلك عن حالة العملية.

ملاحظة

ينطبق هذا الموضوع على PowerShell 5.0. للحصول على معلومات حول إعداد عميل سحب في PowerShell 4.0، راجع إعداد عميل سحب باستخدام معرف التكوين في PowerShell 4.0

تكوين LCM لعميل السحب

يؤدي تنفيذ أي من الأمثلة أدناه إلى إنشاء مجلد إخراج جديد يسمى PullClientConfigName ووضع ملف MOF لتكوين التعريف هناك. في هذه الحالة، سيتم تسمية localhost.meta.mofملف MOF للتكوين التعريفي .

لتطبيق التكوين، اتصل ب Set-DscLocalConfigurationManager cmdlet، مع تعيين المسار إلى موقع ملف MOF لتكوين التعريف. على سبيل المثال:

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

اسم التهيئة

تعين الأمثلة أدناه خاصية ConfigurationName ل LCM إلى اسم تكوين تم تحويله برمجيا مسبقا، تم إنشاؤه لهذا الغرض. ConfigurationName هو ما يستخدمه LCM للعثور على التكوين المناسب على خادم السحب. يجب تسمية <ConfigurationName>.mofملف التكوين MOF على خادم السحب ، في هذه الحالة، "ClientConfig.mof". لمزيد من المعلومات، راجع نشر التكوينات إلى خادم سحب (v4/v5).

إعداد Pull Client لتنزيل التكوينات

يجب تكوين كل عميل في وضع السحب ومنح عنوان URL لخادم السحب حيث يتم تخزين تكوينه. للقيام بذلك، يجب عليك تكوين Configuration Manager المحلي (LCM) بالمعلومات الضرورية. لتكوين LCM، يمكنك إنشاء نوع خاص من التكوين، مزين بسمة DSCLocalConfigurationManager . لمزيد من المعلومات حول تكوين LCM، راجع تكوين Configuration Manager المحلي.

يقوم البرنامج النصي التالي بتكوين LCM لسحب التكوينات من خادم يسمى "CONTOSO-PullSrv".

  • في البرنامج النصي، تحدد كتلة ConfigurationRepositoryWeb خادم السحب. تحدد الخاصية ServerURL نقطة النهاية لخادم السحب.

  • خاصية RegistrationKey هي مفتاح مشترك بين جميع عقد العميل لخادم السحب وخادم السحب هذا. يتم تخزين نفس القيمة في ملف على خادم السحب.

    ملاحظة

    تعمل مفاتيح التسجيل فقط مع خوادم سحب الويب . لا يزال يتعين عليك استخدام ConfigurationID مع خادم سحب SMB . > للحصول على معلومات حول تكوين خادم سحب باستخدام ConfigurationID، راجع إعداد عميل سحب باستخدام معرف التكوين

  • الخاصية ConfigurationNames هي صفيف يحدد أسماء التكوينات المخصصة لعقدة العميل. >ملاحظه: إذا قمت بتحديد أكثر من قيمة واحدة في ConfigurationNames، فيجب عليك أيضا تحديد كتل PartialConfiguration في التكوين الخاص بك. >للحصول على معلومات حول التكوينات الجزئية، راجع تكوينات PowerShell Desired State Configuration الجزئية.

[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

إعداد Pull Client لتنزيل الموارد

إذا قمت بتحديد كتلة ConfigurationRepositoryWeb أو ConfigurationRepositoryShare فقط في تكوين LCM (كما في المثال السابق)، فسيسحب عميل السحب الموارد من نفس الموقع حيث يتم تخزين ملفات ".mof". يمكنك أيضا تحديد مواقع مختلفة حيث يمكن للعملاء تنزيل الموارد. لتحديد خادم مورد، يمكنك استخدام ResourceRepositoryWeb (لخادم سحب ويب) أو كتلة ResourceRepositoryShare (لخادم سحب SMB).

يوضح المثال التالي تكوينا تعريفيا يقوم بإعداد عميل لتنزيل التكوينات من خادم السحب والموارد من مشاركة 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

إعداد عميل سحب للإبلاغ عن الحالة

يمكنك استخدام خادم سحب واحد للتكوينات والموارد وإعداد التقارير. لا يتم تكوين التقارير للعملاء بشكل افتراضي. لتكوين عميل للإبلاغ عن الحالة، يجب عليك إنشاء كتلة ReportRepositoryWeb . يوضح المثال التالي تكوينا تعريفيا يقوم بإعداد عميل لسحب التكوينات والموارد وإرسال بيانات التقارير إلى خادم سحب واحد.

ملاحظة

لا يمكن أن يكون خادم التقارير مشاركة 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

راجع أيضاً