مورد DSC WindowsFeature

ينطبق على: Windows PowerShell 4.0، Windows PowerShell 5.x

يوفر مورد WindowsFeature في Windows PowerShell تكوين الحالة المطلوبة (DSC) آلية لضمان إضافة الأدوار والميزات أو إزالتها على عقدة هدف.

ملاحظة

تغطي هذه الوثائق لمورد DSC هذا الإصدار المضمن مع PowerShell قبل الإصدار 7.2. تحتوي الوحدة النمطية PSDscResources على موارد DSC جديدة ومحدثة تدعمها Microsoft رسميا. تتوفر وحدة PSDscResources من معرض PowerShell.

لمزيد من المعلومات والوثائق المحدثة، راجع الوثائق المرجعية PSDscResources.

بناء الجملة

WindowsFeature [string] #ResourceName
{
    Name = [string]
    [ Credential = [PSCredential] ]
    [ IncludeAllSubFeature = [bool] ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

الخصائص

الخاصية	الوصف
الاسم	يشير إلى اسم الدور أو الميزة التي تريد التأكد من إضافتها أو إزالتها. هذه هي نفس الخاصية Name من Get-WindowsFeature cmdlet، وليس اسم العرض للدور أو الميزة.
بيانات اعتماد	يشير إلى بيانات الاعتماد التي يجب استخدامها لإضافة الدور أو الميزة أو إزالتها.
IncludeAllSubFeature	قم بتعيين هذه الخاصية لضمان $true حالة جميع الميزات الفرعية المطلوبة مع حالة الميزة التي تحددها باستخدام الخاصية Name .
LogPath	يشير إلى المسار إلى ملف سجل حيث تريد من موفر الموارد تسجيل العملية.

الخصائص المشتركة

الخاصية	الوصف
DependsOn	يشير إلى أنه يجب تشغيل تكوين مورد آخر قبل تكوين هذا المورد. على سبيل المثال، إذا كان معرف كتلة البرنامج النصي لتكوين المورد التي تريد تشغيلها أولا هو ResourceName ونوعه هو ResourceType، فإن بناء الجملة لاستخدام هذه الخاصية هو DependsOn = "[ResourceType]ResourceName".
ضمان	يشير إلى ما إذا تمت إضافة الدور أو الميزة. للتأكد من إضافة الدور أو الميزة، قم بتعيين هذه الخاصية إلى تقديم. للتأكد من إزالة الدور أو الميزة، قم بتعيين الخاصية إلى غائب. القيمة الافتراضية هي Present.
PsDscRunAsCredential	تعيين بيانات الاعتماد لتشغيل المورد بأكمله ك.

ملاحظة

تمت إضافة الخاصية الشائعة PsDscRunAsCredential في WMF 5.0 للسماح بتشغيل أي مورد DSC في سياق بيانات الاعتماد الأخرى. لمزيد من المعلومات، راجع استخدام بيانات الاعتماد مع موارد DSC.

مثال

WindowsFeature RoleExample
{
    Ensure = "Present"
    # Alternatively, to ensure the role is uninstalled, set Ensure to "Absent"
    Name = "Web-Server" # Use the Name property from Get-WindowsFeature
}