مشاركة عبر

Invoke-DscResource

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

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

بناء الجملة

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.

ملاحظة

قبل PSDesiredStateConfiguration 2.0.6، يتطلب استخدام Invoke-DscResource في PowerShell 7 تمكين ميزة تجريبية PowerShell. لاستخدام cmdlet في الإصدارات من 2.0.0 إلى 2.0.5، يجب تمكينه باستخدام الأمر التالي.

Enable-ExperimentalFeature PSDesiredStateConfiguration.InvokeDscResource

أمثلة

مثال 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 هذا. القيم المقبولة لهذه المعلمة هي: Get و Set و Test.

Type:String
Accepted values:Get, Set, Test
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

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

Type:ModuleSpecification
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:True
Accept pipeline input:True
Accept wildcard characters:False

-Property

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

Type:Hashtable
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

الإدخالات

String

ModuleSpecification

المخرجات

Object

ملاحظات

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

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