مشاركة عبر

Remove-DscConfigurationDocument

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

إزالة مستند تكوين من مخزن تكوين DSC.

بناء الجملة

Remove-DscConfigurationDocument
      -Stage <Stage>
      [-Force]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

الوصف

يزيل Remove-DscConfigurationDocument cmdlet مستند تكوين (.mofملف) من مخزن تكوين Windows PowerShell Desired State Configuration (DSC). أثناء التكوين، ينسخ Start-DscConfiguration cmdlet ملفا .mof إلى مجلد على الكمبيوتر الهدف. يزيل cmdlet هذا مستند التكوين هذا ويفعل تنظيفا إضافيا.

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

أمثلة

مثال 1: إزالة مستند التكوين الحالي

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Remove-DscConfigurationDocument -Stage Current -CimSession $Session

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

يزيل الأمر الثاني مستند التكوين الحالي للكمبيوتر المحدد في CimSession المخزن في $Session.

المعلمات

-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 في جلسة عمل بعيدة أو على كمبيوتر بعيد. أدخل اسم كمبيوتر أو كائن جلسة عمل، مثل إخراج cmdlet New-CimSession أو .Get-CimSession

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-Force

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

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

-Stage

يحدد مستند التكوين الذي يجب إزالته. يمكنك تحديد مستندات متعددة. القيم المقبولة لهذه المعلمة هي:

  • Current - قم بإزالة مستند التكوين الذي يصف الحالة الحالية للنظام.
  • Pending - قم بإزالة مستند التكوين الذي يصف الحالة المعلقة للنظام.
  • Previous - قم بإزالة مستند التكوين الذي يصف الحالة السابقة للنظام.
Type:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Accepted values:Current, Pending, Previous
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

-WhatIf

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

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

الإدخالات

None

المخرجات

None