إعداد عميل سحب باستخدام معرفات التكوين في PowerShell 4.0

مقالة
06/22/2023

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

هام

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

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

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

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

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

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

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

معرف التكوين

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

يمكنك إنشاء Guid عشوائي باستخدام المثال أدناه.

[System.Guid]::NewGuid()

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

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

خادم سحب HTTP DSC

إذا تم إعداد خادم السحب كخدمة ويب، يمكنك تعيين DownloadManagerName إلى WebDownloadManager. يتطلب WebDownloadManager تحديد ServerUrl إلى مفتاح DownloadManagerCustomData . يمكنك أيضا تحديد قيمة AllowUnsecureConnection، كما في المثال أدناه. يقوم البرنامج النصي التالي بتكوين LCM لسحب التكوينات من خادم يسمى "PullServer".

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24"
        RefreshMode = "PULL"
        DownloadManagerName = "WebDownloadManager"
        RebootNodeIfNeeded = $true
        RefreshFrequencyMins = 30
        ConfigurationModeFrequencyMins = 30
        ConfigurationMode = "ApplyAndAutoCorrect"
        DownloadManagerCustomData = @{
            ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"
            AllowUnsecureConnection = "TRUE"
        }
    }
}
PullClientConfigId -Output "."

إذا تم إعداد خادم السحب كمشاركة ملف SMB، بدلا من خدمة ويب، يمكنك تعيين DownloadManagerName إلى DscFileDownloadManager بدلا من WebDownLoadManager. يتطلب DscFileDownloadManager تحديد خاصية SourcePath في DownloadManagerCustomData. يقوم البرنامج النصي التالي بتكوين LCM لسحب التكوينات من مشاركة SMB المسماة "SmbDscShare" على خادم يسمى "CONTOSO-SERVER".

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    }
}
PullClientConfigId -Output "."

الخطوات التالية

بمجرد تكوين عميل السحب، يمكنك استخدام الدلائل التالية لتنفيذ الخطوات التالية:

مشاركة عبر