مشاركة عبر

Update-DscConfiguration

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

يتحقق من خادم السحب للحصول على تكوين محدث ويطبقه.

بناء الجملة

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

الوصف

Update-DscConfiguration يتصل cmdlet بخادم سحب، وينزل التكوين إذا كان يختلف عما هو حالي على العقدة، ثم يطبق التكوين على الكمبيوتر.

يتوفر أمر cmdlet هذا فقط كجزء من مجموعة تحديثات نوفمبر 2014 ل Windows RT 8.1 Windows 8.1 وWindows Server 2012 R2.

أمثلة

مثال 1: تحديث تكوين

Update-DscConfiguration -Wait -Verbose

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

مثال 2: تحديث تكوين عن طريق الاتصال عبر جلسة عمل CIM

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

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

يحدث الأمر الثاني الكمبيوتر المحدد في CimSession المخزن في $Session. يحدد الأمر المعلمة Wait . لا تقبل وحدة التحكم أوامر إضافية حتى ينتهي الأمر الحالي.

المعلمات

-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 إعدادات التكوين على أجهزة الكمبيوتر التي تحددها هذه المعلمة.

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

-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

-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

-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