مشاركة عبر

Get-DscResource

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

الحصول على موارد تكوين الحالة المطلوبة (DSC) الموجودة على الكمبيوتر.

بناء الجملة

Get-DscResource
   [[-Name] <String[]>]
   [[-Module] <Object>]
   [-Syntax]
   [<CommonParameters>]

الوصف

يسترد Get-DscResource cmdlet موارد PowerShell DSC الموجودة على الكمبيوتر. يكتشف cmdlet هذا الموارد المثبتة في PSModulePath فقط. يعرض تفاصيل حول الموفرين المضمنين والمخصصين، والتي يتم إنشاؤها بواسطة المستخدم. يعرض أمر cmdlet هذا أيضا تفاصيل حول الموارد المركبة، وهي تكوينات أخرى يتم حزمها كوحدة نمطية أو إنشاؤها في وقت التشغيل في جلسة العمل.

أمثلة

مثال 1: الحصول على جميع الموارد على الكمبيوتر المحلي

Get-DscResource

يحصل هذا الأمر على جميع الموارد على الكمبيوتر المحلي.

مثال 2: الحصول على مورد عن طريق تحديد الاسم

Get-DscResource -Name "WindowsFeature"

يحصل هذا الأمر على مورد WindowsFeature.

مثال 3: الحصول على جميع الموارد من وحدة نمطية

Get-DscResource -Module "xHyper-V"

يحصل هذا الأمر على جميع الموارد من الوحدة النمطية xHyper-V.

مثال 4: الحصول على مورد باستخدام أحرف البدل

Get-DscResource -Name P*,r*

يحصل هذا الأمر على جميع الموارد التي تطابق نمط حرف البدل المحدد بواسطة المعلمة Name .

مثال 5: الحصول على بناء جملة مورد

Get-DscResource -Name "WindowsFeature" -Syntax

يحصل هذا الأمر على مورد WindowsFeature، ويعرض بناء جملة المورد.

مثال 6: الحصول على جميع خصائص مورد

Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties

يحصل هذا الأمر على مورد المستخدم، ثم يستخدم عامل تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية لإرجاع جميع خصائص مورد المستخدم.

مثال 7: الحصول على جميع الموارد من وحدة نمطية محددة بإصدار محدد

Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}

يحصل هذا الأمر على جميع الموارد من وحدة xHyper-V النمطية مع الإصدار 3.0.0.0.

المعلمات

-Module

يحدد الاسم أو الاسم المؤهل بالكامل للوحدة النمطية التي سيتم عرض مورد DSC لها.

Type:Object
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

تحديد صفيف من أسماء مورد DSC لعرضه.

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

-Syntax

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

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

الإدخالات

String[]

Object

المخرجات

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]