群組

概要

管理本機群組。

語法

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

範例

• 設定群組的成員
• 移除群組的成員