组

摘要

管理本地组。

语法

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

Ensure

指定组是否应存在。 若要添加或更新组，请将此属性设置为 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>

请勿将此属性与 Members 属性一起使用。 如果这样做，资源将引发异常。

Type: System.String[]
Default Value: None

MembersToInclude

指定要作为字符串数组包含在组中的一个或多个成员。 如果指定此属性，则资源会从组中添加这些成员（如果不包含这些成员）。 将每个成员格式化为下列成员之一：

• 域限定名称： <domain>\<username>
• Upn： <username>@<domain>
• 可分辨名称： CN=<username>,DC=...
• 用户名：<username>

请勿将此属性与 Members 属性一起使用。 如果这样做，资源将引发异常。

Type: System.String[]
Default Value: None

示例

• 设置组的成员
• 删除组的成员