Start-DscConfiguration

الوحدة النمطية:

PSDesiredStateConfiguration

تطبيق التكوين على العقد.

بناء الجملة

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

الوصف

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

بشكل افتراضي، يقوم cmdlet هذا بإنشاء مهمة وإرجاع كائن Job . لمزيد من المعلومات حول وظائف الخلفية، اكتب Get-Help about_Jobs. لاستخدام cmdlet هذا بشكل تفاعلي، حدد المعلمة Wait .

حدد المعلمة Verbose للاطلاع على تفاصيل ما يفعله cmdlet عند تطبيق إعدادات التكوين.

أمثلة

مثال 1: تطبيق إعدادات التكوين

Start-DscConfiguration -Path "C:\DSC\Configurations\"

يطبق هذا الأمر إعدادات التكوين من C:\DSC\Configurations\ إلى كل كمبيوتر يحتوي على إعدادات في هذا المجلد. يقوم الأمر بإرجاع كائنات المهمة لكل عقدة هدف تم نشرها إليها.

مثال 2: تطبيق إعدادات التكوين وانتظر حتى يكتمل التكوين

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

يطبق هذا الأمر التكوين من C:\DSC\Configurations\ على الكمبيوتر المحلي. يقوم الأمر بإرجاع كائنات المهمة لكل عقدة هدف تم نشرها إلى الكمبيوتر المحلي فقط في هذه الحالة. يحدد هذا المثال المعلمة Verbose . لذلك، يرسل الأمر رسائل إلى وحدة التحكم أثناء متابعة. يتضمن الأمر المعلمة Wait . لذلك، لا يمكنك استخدام وحدة التحكم حتى ينتهي الأمر من جميع مهام التكوين.

مثال 3: تطبيق إعدادات التكوين باستخدام جلسة عمل CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

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

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

يطبق الأمر الثاني إعدادات التكوين من C:\DSC\Configurations على أجهزة الكمبيوتر المحددة بواسطة كائنات CimSession المخزنة $Session في المتغير. في هذا المثال، $Session يحتوي المتغير على جلسة عمل CIM فقط للكمبيوتر المسمى Server01. يطبق الأمر التكوين. يقوم الأمر بإنشاء كائنات المهمة لكل كمبيوتر تم تكوينه.

المعلمات

-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

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

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

-Confirm

يطالبك بالتأكيد قبل تشغيل cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
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

-Force

إيقاف عملية التكوين قيد التشغيل حاليا على الكمبيوتر الهدف وبدء عملية Start-Configuration الجديدة. إذا تم تعيين الخاصية RefreshMode Configuration Manager المحلي على Pull، فإن تحديد هذه المعلمة يغيرها إلى Push.

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

-JobName

يحدد اسما مألوفا لوظيفة. إذا قمت بتحديد هذه المعلمة، يتم تشغيل cmdlet كوظيفة، ويعيد كائن Job .

بشكل افتراضي، يعين Windows PowerShell الاسم JobN حيث N هو عدد صحيح.

إذا قمت بتحديد المعلمة Wait ، فلا تحدد هذه المعلمة.

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

-Path

يحدد مسار ملف لمجلد يحتوي على ملفات إعدادات التكوين. ينشر cmdlet هذا إعدادات التكوين هذه ويطبقها على أجهزة الكمبيوتر التي تحتوي على ملفات إعدادات في المسار المحدد. يجب أن تحتوي كل عقدة مستهدفة على ملف إعدادات بالتنسيق التالي: <NetBIOS Name>.mof.

Type:	String
Position:	0
Default value:	None
Required:	False
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

-UseExisting

يشير إلى أن cmdlet هذا يطبق التكوين الموجود. يمكن أن يكون التكوين موجودا على الكمبيوتر الهدف عن طريق التشريع باستخدام Start-DscConfiguration أو عن طريق النشر باستخدام Publish-DscConfiguration cmdlet.

قبل تحديد هذه المعلمة ل cmdlet هذا، راجع المعلومات الموجودة في ما الجديد في Windows PowerShell 5.0.

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

-Wait

يشير إلى أن cmdlet يحظر وحدة التحكم حتى تنتهي من جميع مهام التكوين.

إذا قمت بتحديد هذه المعلمة، فلا تحدد المعلمة JobName .

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

-WhatIf

تعرض ما سيحدث عند تشغيل الأمر cmdlet. لم يتم تشغيل cmdlet.

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

الارتباطات المرتبطة

• Windows PowerShell نظرة عامة على تكوين الحالة المطلوبة
• Get-DscConfiguration
• Get-DscConfigurationStatus
• Restore-DscConfiguration
• Stop-DscConfiguration
• Test-DscConfiguration
• Update-DscConfiguration