تكوين LCM في PowerShell 4.0

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

للحصول على معلومات تتعلق Windows PowerShell 5.0 والإصدارات الأحدث، راجع تكوين Configuration Manager المحلي.

Configuration Manager المحلي هو محرك تكوين الحالة المطلوبة (DSC) Windows PowerShell. يتم تشغيله على جميع العقد الهدف، وهو مسؤول عن استدعاء موارد التكوين المضمنة في البرنامج النصي لتكوين DSC. يسرد هذا الموضوع خصائص Configuration Manager المحلي ويصف كيف يمكنك تعديل إعدادات Configuration Manager المحلية على عقدة هدف.

خصائص Configuration Manager المحلية

يسرد التالي خصائص Configuration Manager المحلية التي يمكنك تعيينها أو استردادها.

  • AllowModuleOverwrite: يتحكم في ما إذا كان يسمح للتكوينات الجديدة التي تم تنزيلها من خدمة التكوين بالكتابة فوق التكوينات القديمة على العقدة الهدف. القيم المحتملة هي True و False.
  • CertificateID: بصمة إبهام الشهادة المستخدمة لتأمين بيانات الاعتماد التي تم تمريرها في تكوين. لمزيد من المعلومات، راجع هل تريد تأمين بيانات الاعتماد في Windows PowerShell تكوين الحالة المطلوبة؟.
  • ConfigurationID: يشير إلى GUID الذي يستخدم للحصول على ملف تكوين معين من خدمة سحب. يضمن GUID الوصول إلى ملف التكوين الصحيح.
  • ConfigurationMode: يحدد كيفية تطبيق Configuration Manager المحلي للتكوين فعليا على العقد الهدف. قد يستغرق الأمر القيم التالية:
    • ApplyOnly: باستخدام هذا الخيار، يطبق DSC التكوين ولا يفعل أي شيء آخر ما لم يتم الكشف عن تكوين جديد، إما عن طريق إرسال تكوين جديد مباشرة إلى العقدة الهدف أو إذا كنت تتصل بخدمة سحب ويكتشف DSC تكوينا جديدا عند التحقق من خدمة السحب. إذا انحرف تكوين العقدة الهدف، فلن يتم اتخاذ أي إجراء.
    • ApplyAndMonitor: باستخدام هذا الخيار (وهو الخيار الافتراضي)، يطبق DSC أي تكوينات جديدة، سواء تم إرسالها من قبلك مباشرة إلى العقدة الهدف أو تم اكتشافها على خدمة سحب. بعد ذلك، إذا انحرف تكوين العقدة الهدف عن ملف التكوين، فإن DSC يبلغ عن التناقض في السجلات. لمزيد من المعلومات حول تسجيل DSC، راجع استخدام سجلات الأحداث لتشخيص الأخطاء في تكوين الحالة المطلوبة.
    • ApplyAndAutoCorrect: باستخدام هذا الخيار، يطبق DSC أي تكوينات جديدة، سواء تم إرسالها من قبلك مباشرة إلى العقدة الهدف أو تم اكتشافها على خدمة سحب. بعد ذلك، إذا انحرف تكوين العقدة الهدف عن ملف التكوين، فإن DSC يبلغ عن التناقض في السجلات، ثم يحاول ضبط تكوين العقدة الهدف لتحقيق التوافق مع ملف التكوين.
  • ConfigurationModeFrequencyMins: يمثل التردد (بالدقائق) الذي يحاول فيه تطبيق الخلفية ل DSC تنفيذ التكوين الحالي على العقدة الهدف. القيمة الافتراضية هي 15. يمكن تعيين هذه القيمة بالاقتران مع RefreshMode. عند تعيين RefreshMode إلى PULL، تتصل العقدة الهدف بخدمة التكوين في فاصل زمني تم تعيينه بواسطة RefreshFrequencyMins وتنزيل التكوين الحالي. بغض النظر عن قيمة RefreshMode، في الفاصل الزمني الذي تم تعيينه بواسطة ConfigurationModeFrequencyMins، يطبق محرك التناسق أحدث تكوين تم تنزيله على العقدة الهدف. يجب تعيين RefreshFrequencyMins إلى عدد صحيح متعدد من ConfigurationModeFrequencyMins.
  • بيانات الاعتماد: تشير إلى بيانات الاعتماد (كما هو الحال مع Get-Credential) المطلوبة للوصول إلى الموارد البعيدة، مثل الاتصال بخدمة التكوين.
  • DownloadManagerCustomData: يمثل صفيفا يحتوي على بيانات مخصصة خاصة بمدير التنزيل.
  • DownloadManagerName: يشير إلى اسم مدير تنزيل التكوين والوحدة النمطية.
  • RebootNodeIfNeededed: قم بتعيين هذا للسماح $true للموارد بإعادة تشغيل العقدة باستخدام العلامة $global:DSCMachineStatus . وإلا، يتعين عليك إعادة تشغيل العقدة يدويا لأي تكوين يتطلبها. القيمة الافتراضية هي $false. لاستخدام هذا الإعداد عند تفعيل شرط إعادة التشغيل بواسطة شيء آخر غير DSC (مثل Windows Installer)، ادمج هذا الإعداد مع الوحدة النمطية xPendingReboot .
  • RefreshFrequencyMins: يستخدم عند إعداد خدمة سحب. يمثل التردد (بالدقائق) الذي يتصل فيه Configuration Manager المحلي بخدمة سحب لتنزيل التكوين الحالي. يمكن تعيين هذه القيمة بالاقتران مع ConfigurationModeFrequencyMins. عند تعيين RefreshMode إلى PULL، تتصل العقدة الهدف بخدمة السحب في فاصل زمني تم تعيينه بواسطة RefreshFrequencyMins وتنزيل التكوين الحالي. في الفاصل الزمني الذي تم تعيينه بواسطة ConfigurationModeFrequencyMins، يطبق محرك التناسق بعد ذلك أحدث تكوين تم تنزيله على العقدة الهدف. إذا لم يتم تعيين RefreshFrequencyMins إلى عدد صحيح من مضاعفات ConfigurationModeFrequencyMins، سيقوم النظام بتقريبه لأعلى. القيمة الافتراضية هي 30.
  • RefreshMode: القيم المحتملة هي Push (الافتراضي) و Pull. في تكوين "الدفع"، يجب وضع ملف تكوين على كل عقدة هدف، باستخدام أي كمبيوتر عميل. في وضع "السحب"، يجب إعداد خدمة سحب Configuration Manager المحلي للاتصال بملفات التكوين والوصول إليها.

ملاحظة

يبدأ LCM دورة ConfigurationModeFrequencyMins استنادا إلى:

  • يتم تطبيق metaconfig جديد باستخدام Set-DscLocalConfigurationManager
  • إعادة تشغيل الجهاز

لأي شرط تواجه فيه عملية المؤقت تعطلا، سيتم الكشف عنه في غضون 30 ثانية وستتم إعادة تشغيل الدورة. قد تؤدي العملية المتزامنة إلى تأخير الدورة من البدء، إذا تجاوزت مدة هذه العملية تكرار الدورة المكونة، فلن يبدأ المؤقت التالي.

على سبيل المثال، يتم تكوين metaconfig بتردد سحب مدته 15 دقيقة ويحدث السحب في T1. لا تنتهي العقدة من العمل لمدة 16 دقيقة. يتم تجاهل دورة ال 15 دقيقة الأولى، وسيحدث السحب التالي في T1+15+15.

مثال على تحديث إعدادات Configuration Manager المحلية

يمكنك تحديث إعدادات Configuration Manager المحلية لعقدة هدف عن طريق تضمين كتلة LocalConfigurationManager داخل كتلة العقدة في برنامج نصي للتكوين، كما هو موضح في المثال التالي.

Configuration ExampleConfig
{
    Node "Server001"
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called
# Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

يؤدي تشغيل البرنامج النصي في المثال السابق إلى إنشاء ملف MOF يحدد الإعدادات المطلوبة ويخزنها. لتطبيق الإعدادات، يمكنك استخدام Cmdlet Set-DscLocalConfigurationManager ، كما هو موضح في المثال التالي.

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

ملاحظة

بالنسبة لمعلمة المسار ، يجب تحديد نفس المسار الذي حددته للمعلمة OutputPath عند استدعاء التكوين في المثال السابق.

لمشاهدة إعدادات Configuration Manager المحلية الحالية، يمكنك استخدام الأمر Cmdlet Get-DscLocalConfigurationManager. إذا قمت باستدعاء أمر cmdlet هذا بدون معلمات، فسيحصل بشكل افتراضي على إعدادات Configuration Manager المحلية للعقدة التي تقوم بتشغيلها عليها. لتحديد عقدة أخرى، استخدم المعلمة CimSession مع cmdlet هذا.