Set-Group

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2009-05-12

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

Синтаксис

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

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

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

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

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

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

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

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

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

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

Параметры

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

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

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

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

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

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

  • Имя

  • Краткое имя

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

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.

DisplayName

Необязательный

System.String

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

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

IgnoreDefaultScope

Необязательный

System.Management.Automation.SwitchParameter

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

  • Использовать параметр DomainController нельзя. Команда будет использовать подходящий сервер глобального каталога автоматически.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

Instance

Необязательный

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

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

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

ManagedBy

Необязательный

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

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

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

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

  • Имя

  • Краткое имя

Name

Необязательный

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.

UseRusServer

Необязательный

System.String

noteПримечание.
Этот параметр доступен только в Exchange 2007 с пакетом обновления 2 (SP2).

Параметр UseRusServer указывает на необходимость использования определенного сервера почтовых ящиков, на котором выполняется служба списка адресов, для получения и установки атрибутов почтового ящика и пользователя Active Directory.

Служба списка адресов является компонентом службы системного помощника Exchange. С ее помощью создаются и поддерживаются характерные для Exchange значения атрибутов в Active Directory. Служба списка адресов позволяет обновлять объекты получателя в домене с использованием определенных сведений, таких как членство в списке адресов и адреса электронной почты.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

WindowsEmailAddress

Необязательный

Microsoft.Exchange.Data.SmtpAddress

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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

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