مشاركة عبر

Publish-DscConfiguration

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

ينشر تكوين DSC إلى مجموعة من أجهزة الكمبيوتر.

بناء الجملة

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

الوصف

Publish-DscConfiguration ينشر cmdlet مستند تكوين Windows PowerShell Desired State Configuration (DSC) على مجموعة من أجهزة الكمبيوتر. لا يطبق cmdlet هذا التكوين. يتم تطبيق التكوينات إما بواسطة Start-DscConfiguration cmdlet عند استخدامها مع المعلمة UseExisting أو عند تشغيل محرك DSC لدورة التناسق الخاصة به. يعرف محرك DSC أيضا باسم Configuration Manager المحلي (LCM).

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

أمثلة

مثال 1: نشر تكوين إلى كمبيوتر بعيد

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

ينشر هذا الأمر تكوينا إلى كمبيوتر بعيد. يجب أن يكون المستخدم الذي يقوم بتشغيل cmdlet مسؤولا على الكمبيوتر البعيد.

المعلمات

-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

يحدد بيانات الاعتماد المستخدمة للوصول إلى الجهاز الهدف.

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

-Force

يفرض الأمر cmdlet على الانتهاء. إذا تم تعيين وضع تحديث Configuration Manager المحلي إلى PULL، فإن استخدام هذه المعلمة يغيره إلى PUSH ويمكن نشر تكوين DSC. أيضا، إذا كان هناك تكوين DSC معلق، فإن استخدام هذه المعلمة يحل محل هذا التكوين المعلق.

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

-Path

يحدد مسارا يحتوي على تكوينات للنشر إلى أجهزة الكمبيوتر المستهدفة.

Type:String
Position:0
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

-WhatIf

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

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