Invoke-DscResource

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

تشغيل أسلوب لمورد PowerShell Desired State Configuration (DSC) محدد.

بناء الجملة

Default (افتراضي) 

Invoke-DscResource
    [-Name] <String>
    [[-ModuleName] <ModuleSpecification>]
    [-Method] <String>
    [-Property] <Hashtable>
    [<CommonParameters>]

الوصف

يقوم Invoke-DscResource cmdlet بتشغيل أسلوب لمورد PowerShell Desired State Configuration (DSC) محدد.

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

لا يعمل cmdlet هذا مع الموارد المركبة. الموارد المركبة هي تكوينات ذات معلمات. يتطلب استخدام الموارد المركبة LCM.

أمثلة

مثال 1: استدعاء الأسلوب Set لمورد عن طريق تحديد خصائصه الإلزامية

يستدعي هذا المثال أسلوب Set لمورد يسمى WindowsProcess ويوفر خصائص مسار الإلزامية والوسيطات لبدء عملية Windows المحددة.

Invoke-DscResource -Name WindowsProcess -Method Set -ModuleName PSDesiredStateConfiguration -Property @{
    Path      = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
    Arguments = ''
}

مثال 2: استدعاء أسلوب الاختبار لمورد لوحدة نمطية محددة

يستدعي هذا المثال أسلوب اختبار لمورد يسمى WindowsProcess، الموجود في الوحدة النمطية المسماة PSDesiredStateConfiguration.

$SplatParam = @{
    Name       = 'WindowsProcess'
    ModuleName = 'PSDesiredStateConfiguration'
    Method     = 'Test'
    Property   = @{
        Path      = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
        Arguments = ''
    }
}

Invoke-DscResource @SplatParam

المعلمات

-Method

يحدد أسلوب المورد الذي يستدعيه أمر cmdlet هذا. القيم المقبولة لهذه المعلمة هي: الحصول علىتعييناختبار.

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

النوع:String
القيمة الافتراضية:None
القيم المقبولة:Get, Set, Test
يدعم أحرف البدل:False
DontShow:False

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

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

-ModuleName

يحدد اسم الوحدة النمطية التي توفر مورد DSC المحدد لاستدعاءه.

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

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

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

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

-Name

يحدد اسم مورد DSC المراد استدعاؤه.

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

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

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

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

-Property

تحديد اسم خاصية المورد وقيمته في جدول التجزئة كمفتاح وقيمة، على التوالي.

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

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

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

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

CommonParameters

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

الإدخالات

String

ModuleSpecification

المخرجات

Object

ملاحظات

  • في Windows PowerShell 5.1 يتم تشغيل الموارد ضمن سياق النظام ما لم يتم تحديدها مع سياق المستخدم باستخدام المفتاح PsDscRunAsCredential. في PowerShell 7.0، يتم تشغيل الموارد في سياق المستخدم، ولم يعد PsDscRunAsCredential مدعوما. يؤدي استخدام هذا المفتاح إلى طرح cmdlet استثناء.

  • اعتبارا من PowerShell 7، لم يعد Invoke-DscResource يدعم استدعاء موارد WMI DSC. يتضمن ذلك ملف وموارد سجل في PSDesiredStateConfiguration.