Поделиться через

Группа

  • Статья

Краткий обзор

Управление локальной группой.

Синтаксис

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

Description

Укажите описание группы.

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

Примеры