التجميع

  • مقالة

الخلاصة

إدارة مجموعة محلية.

بناء الجملة

Group [String] #ResourceName
{
    GroupName = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Members = [string[]]]
    [MembersToExclude = [string[]]]
    [MembersToInclude = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
}

الوصف

Group يمكنك المورد من إدارة المجموعات المحلية. يمكنه إنشاء المجموعات وتحديثها وإزالتها. يمكنك استخدام هذا المورد لفرض عضوية المجموعة وتعيين وصف المجموعة.

المتطلبات

لا شيء

الخصائص الرئيسية

Groupname

حدد اسم المجموعة.

Type: System.String

خصائص اختيارية

بيانات اعتماد

حدد بيانات الاعتماد لحساب له إذن لحل أعضاء المجموعة غير المحليين إذا لزم الأمر.

Type: System.Management.Automation.PSCredential
Default Value: None

الوصف

حدد وصف المجموعة.

Type: System.String
Default Value: None

ضمان

حدد ما إذا كان يجب أن تكون المجموعة موجودة أم لا. لإضافة مجموعة أو تحديثها، قم بتعيين هذه الخاصية إلى Present. لإزالة مجموعة، قم بتعيين هذه الخاصية إلى Absent. القيمة الافتراضية هي Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

الأعضاء

حدد القائمة الكاملة لأعضاء المجموعة كصفيف من السلاسل. إذا قمت بتحديد هذه الخاصية، يقوم المورد بتعيين قائمة أعضاء المجموعة إلى هذه القيمة. تنسيق كل عضو كأحد الإجراءات التالية:

  • اسم المجال المؤهل: <domain>\<username>
  • Upn: <username>@<domain>
  • الاسم المميز: CN=<username>,DC=...
  • المستخدم: <username>

لا تستخدم هذه الخاصية مع خصائص MembersToExclude أو MembersToInclude . إذا قمت بذلك، يطرح المورد استثناء.

Type: System.String[]
Default Value: None

MembersToExclude

حدد عضوا واحدا أو أكثر لاستبعاده من المجموعة كصفيف من السلاسل. إذا قمت بتحديد هذه الخاصية، يقوم المورد بإزالة هؤلاء الأعضاء من المجموعة إذا كان يتضمنهم. تنسيق كل عضو كأحد الإجراءات التالية:

  • اسم المجال المؤهل: <domain>\<username>
  • Upn: <username>@<domain>
  • الاسم المميز: CN=<username>,DC=...
  • المستخدم: <username>

لا تستخدم هذه الخاصية مع خاصية الأعضاء . إذا قمت بذلك، يطرح المورد استثناء.

Type: System.String[]
Default Value: None

MembersToInclude

حدد عضوا واحدا أو أكثر لتضمينه في المجموعة كصفيف من السلاسل. إذا قمت بتحديد هذه الخاصية، يضيف المورد هؤلاء الأعضاء من المجموعة إذا لم يتضمنهم. تنسيق كل عضو كأحد الإجراءات التالية:

  • اسم المجال المؤهل: <domain>\<username>
  • Upn: <username>@<domain>
  • الاسم المميز: CN=<username>,DC=...
  • المستخدم: <username>

لا تستخدم هذه الخاصية مع خاصية الأعضاء . إذا قمت بذلك، يطرح المورد استثناء.

Type: System.String[]
Default Value: None

أمثلة