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


Командлет Set-Group (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-17

С помощью командлета Set-Group можно изменить параметры существующей группы Microsoft Windows.

Синтаксис

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-DisplayName <String>] [-DomainController <Fqdn>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

Подробное описание

С помощью командлета Set-Group можно изменить параметры групповых объектов, отображаемых в оснастке Active Directory «Пользователи и компьютеры». Если группа представляет собой группу безопасности или группу распространения, поддерживающую почту, с помощью командлета Set-DistributionGroup можно изменить другие параметры Microsoft Exchange Server 2007, которые недоступны при использовании командлета Set-Group.

Командлет Set-Group нельзя использовать для изменения динамических групп рассылки. Для изменения динамических групп рассылки следует использовать командлет Set-DynamicDistributionGroup. Дополнительные сведения о командлете Set-DynamicDistributionGroup см. в разделе Командлет Set-DynamicDistributionGroup (окончательная первоначальная версия).

Для выполнения командлета Set-Group используемой учетной записи необходимо делегировать следующие роли:

  • роль администратора получателей Exchange.

  • роль оператора учета для соответствующих контейнеров Active Directory.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательность Тип Описание

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Параметр Identity определяет объект, который необходимо изменить. Параметр Identity для группы может принимать только одно из следующих значений:

  • Различающееся имя (DN)

  • Каноническое имя

  • GUID;

  • Имя

  • краткое имя

Параметр Identity нельзя использовать в сочетании с параметром Instance.

DisplayName

Дополнительно

System.String

Параметр DisplayName указывает имя группы в консоли управления Exchange и в глобальном списке адресов Exchange. Этот параметр важен только в том случае, если группа является почтовой.

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

С помощью параметра DomainController можно указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory.

Instance

Дополнительно

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект.

Параметр Instance нельзя использовать в сочетании с параметром Identity.

ManagedBy

Дополнительно

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Параметр ManagedBy указывает имя пользователя, группы или контакта, которое отображается на вкладке Управляется объекта Active Directory. Для этого параметра доступны следующие значения:

  • Различающееся имя (DN)

  • Каноническое имя

  • GUID;

  • Имя

  • краткое имя

Имя

Дополнительно

System.String

Параметр Name указывает имя группы. Параметр Name указывает имя группы в оснастке Active Directory «Пользователи и компьютеры», а также в поле Имя группы в консоли управления Exchange, если группа является почтовой.

Notes

Дополнительно

System.String

Параметр Notes указывает примечания, которые описывают цель данной группы.

PhoneticDisplayName

Дополнительно

System.String

Параметр PhoneticDisplayName определяет фонетическую транскрипцию параметра DisplayName.

Максимальная длина этого параметра составляет 255 знаков. Дополнительные сведения о параметре PhoneticDisplayName и автоматическом распознавании речи см. в разделе Поиск в каталоге автоматического распознавания речи.

SimpleDisplayName

Дополнительно

System.String

Параметр SimpleDisplayName отображает альтернативное описание объекта, если разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает набор знаков ASCII от 26 до 126 включительно. Параметр SimpleDisplayName имеет значение только для объектов, разрешенных в единой системе обмена сообщениями.

Universal

Дополнительно

System.Management.Automation.SwitchParameter

Параметр Universal изменяет область группы с global или domain local на universal.

WindowsEmailAddress

Дополнительно

Microsoft.Exchange.Data.SmtpAddress

Параметр WindowsEmailAddress указывает значение поля Электронная почта объекта Active Directory.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

В следующем примере показано, как с помощью командлета Set-Group применить следующие изменения для существующей глобальной группы безопасности с именем «Legal Department»:

  • Изменение области действия группы на универсальную

  • Добавление параметра «Notes» со значением verified

Set-Group -Identity "Legal Department" -Universal -Notes "verified"