Get-DscResource

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

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

بناء الجملة

Default (افتراضي) 

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

الوصف

يقوم الأمر cmdlet Get-DscResource باسترداد موارد 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 لها.

خصائص المعلمات

النوع:Object
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

(All)
Position:1
إلزامي:False
القيمة من مسار معالجة البيانات:True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:True
القيمة من الوسائط المتبقية:False

-Name

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

خصائص المعلمات

النوع:

String[]

القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

(All)
Position:0
إلزامي:False
القيمة من مسار معالجة البيانات:True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:True
القيمة من الوسائط المتبقية:False

-Syntax

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

خصائص المعلمات

النوع:SwitchParameter
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

(All)
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

CommonParameters

يدعم cmdlet هذا المعلمات الشائعة: -Debug و -ErrorAction و -ErrorVariable و -InformationAction و -InformationVariable و -OutBuffer و -OutVariable و -PipelineVariable و -ProgressAction و -Verbose و -WarningAction و -WarningVariable. لمزيد من المعلومات، راجع about_CommonParameters.

الإدخالات

String

Object

المخرجات

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo

String