Get-DscResource
الحصول على موارد تكوين الحالة المطلوبة (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[]
المخرجات
Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]
string[]