مشاركة عبر

Test-DscConfiguration

  • ‏‏المرجع
الوحدة النمطية:
PSDesiredStateConfiguration

يختبر ما إذا كان التكوين الفعلي على العقد يطابق التكوين المطلوب.

بناء الجملة

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

الوصف

يختبر Test-DscConfiguration cmdlet ما إذا كان التكوين الفعلي على العقد يطابق التكوين المطلوب. حدد أجهزة الكمبيوتر التي تريد اختبار التكوينات لها باستخدام أسماء أجهزة الكمبيوتر أو جلسات عمل نموذج المعلومات العامة (CIM). إذا لم تحدد جهاز كمبيوتر مستهدفا، يختبر cmdlet تكوين الكمبيوتر المحلي.

إذا تطابقت التكوينات المطلوبة والفعلية، يقوم cmdlet بإرجاع قيمة سلسلة "True". وإلا، فإنه يقوم بإرجاع قيمة سلسلة من "False".

أمثلة

مثال 1: اختبار التكوين للكمبيوتر المحلي

Test-DscConfiguration

يختبر هذا الأمر تكوين الكمبيوتر المحلي.

مثال 2: اختبار التكوين لجهاز كمبيوتر محدد

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

هذا المثال اختبار التكوين من كمبيوتر محدد بواسطة جلسة عمل CIM. ينشئ المثال جلسة عمل CIM لجهاز كمبيوتر يسمى Server01 للاستخدام مع cmdlet. بدلا من ذلك، قم بإنشاء صفيف من جلسات CIM لتطبيق cmdlet على أجهزة كمبيوتر محددة متعددة.

ينشئ الأمر الأول جلسة عمل CIM باستخدام New-CimSession cmdlet، ثم يخزن كائن CimSession في $Session المتغير . يطالبك الأمر بكلمة مرور. لمزيد من المعلومات، اكتب Get-Help New-CimSession.

يختبر الأمر الثاني تكوين أجهزة الكمبيوتر المحددة بواسطة كائنات CimSession المخزنة $Session في المتغير، في هذه الحالة، الكمبيوتر المسمى Server01.

مثال 3: اختبار التكوينات مع نتائج مفصلة

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

يختبر هذا الأمر تكوينات مجموعة من أجهزة الكمبيوتر المحددة بواسطة المعلمة ComputerName ويعيد معلومات مفصلة تتضمن الحالة الإجمالية والموارد الموجودة في الحالة المطلوبة والموارد غير الموجودة في الحالة المطلوبة واسم الكمبيوتر.

مثال 4: اختبار التكوينات المحددة في مجلد

Test-DscConfiguration -Path "C:\Dsc\Configurations"

يختبر هذا الأمر التكوينات المعرفة في مجلد محدد بواسطة المعلمة Path . يتم اختبار التكوينات مقابل مجموعة من أجهزة الكمبيوتر، كل منها تم تحديده بواسطة اسم ملف ملف التكوين.

مثال 5: اختبار التكوينات المحددة في ملف

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

يختبر هذا الأمر تكوينا معرفا في ملف مقابل مجموعة من أجهزة الكمبيوتر المحددة بواسطة المعلمة ComputerName .

المعلمات

-AsJob

يشير إلى أن cmdlet هذا يقوم بتشغيل الأمر كوظيفة خلفية.

إذا قمت بتحديد المعلمة AsJob ، يقوم الأمر بإرجاع كائن يمثل المهمة، ثم يعرض موجه الأوامر. يمكنك الاستمرار في العمل في جلسة العمل حتى تنتهي المهمة. يتم إنشاء المهمة على الكمبيوتر المحلي ويتم إرجاع النتائج من أجهزة الكمبيوتر البعيدة تلقائيا إلى الكمبيوتر المحلي. لإدارة المهمة، استخدم أوامر cmdlets للوظيفة. للحصول على نتائج المهمة، استخدم Receive-Job cmdlet.

لاستخدام هذه المعلمة، يجب تكوين أجهزة الكمبيوتر المحلية والنائية للاتصال عن بعد، وعلى Windows Vista والإصدارات الأحدث من نظام التشغيل Windows، يجب فتح Windows PowerShell باستخدام الخيار تشغيل كمسؤول. لمزيد من المعلومات، راجع about_Remote_Requirements.

لمزيد من المعلومات حول مهام الخلفية Windows PowerShell، راجع about_Jobsabout_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

تشغيل cmdlet في جلسة عمل بعيدة أو على كمبيوتر بعيد. أدخل اسم كمبيوتر أو عنصر جلسة عمل، مثل إخراج New-CimSession أو Get-CimSession cmdlet. الافتراضي هو جلسة العمل الحالية على الكمبيوتر المحلي.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

يحدد صفيفا من أسماء أجهزة الكمبيوتر التي يختبر أمر cmdlet هذا التكوين عليها. يختبر cmdlet مستند التكوين في الموقع المحدد بواسطة المعلمة Path إلى أجهزة الكمبيوتر هذه.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

يحدد اسم مستخدم وكلمة مرور، كعنصر PSCredential ، للكمبيوتر الهدف. للحصول على كائن PSCredential ، استخدم Get-Credential cmdlet. لمزيد من المعلومات، اكتب Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

يحدد مسار مجلد يحتوي على ملفات مستندات التكوين. يختبر cmdlet التكوين مقابل الحالة المطلوبة لأجهزة الكمبيوتر المحددة بواسطة معلمة ComputerName أو CimSession .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceConfiguration

يحدد مسار ملف مستند التكوين. يختبر cmdlet هذا التكوين مقابل الحالة الفعلية لأجهزة الكمبيوتر المحددة بواسطة معلمة ComputerName أو CimSession .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

يحدد الحد الأقصى لعدد العمليات المتزامنة التي يمكن إنشاؤها لتشغيل cmdlet. إذا تم حذف هذه المعلمة أو تم إدخال قيمة0، فإن Windows PowerShell تحسب حد التقييد الأمثل ل cmdlet استنادا إلى عدد أوامر cmdlets ل CIM التي تعمل على الكمبيوتر. ينطبق حد التقييد فقط على cmdlet الحالي، وليس على جلسة العمل أو على الكمبيوتر.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False