Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-24

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

Синтаксис


`Set-Group -Identity <GroupIdParameter> [-BypassSecurityGroupManagerCheck <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-IsHierarchicalGroup <$true \| $false>] [-ManagedBy <GeneralRecipientIdParameter[]>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SeniorityIndex <Int32>] [-SimpleDisplayName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]`

Set-Group -Identity <GroupIdParameter>
[-BypassSecurityGroupManagerCheck <SwitchParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-IgnoreDefaultScope
<SwitchParameter>] [-IsHierarchicalGroup <$true |
$false>] [-ManagedBy <GeneralRecipientIdParameter[]>]
[-Name <String>] [-Notes <String>]
[-PhoneticDisplayName <String>] [-SeniorityIndex
<Int32>] [-SimpleDisplayName <String>] [-WhatIf
[<SwitchParameter>]] [-WindowsEmailAddress
<SmtpAddress>]


Set-Group -Identity <GroupIdParameter> [-BypassSecurityGroupManagerCheck <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-IsHierarchicalGroup <$true \| $false>] [-ManagedBy <GeneralRecipientIdParameter[]>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SeniorityIndex <Int32>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter>
[-BypassSecurityGroupManagerCheck <SwitchParameter>]
[-Confirm [<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-IgnoreDefaultScope
<SwitchParameter>] [-IsHierarchicalGroup <$true |
$false>] [-ManagedBy <GeneralRecipientIdParameter[]>]
[-Name <String>] [-Notes <String>]
[-PhoneticDisplayName <String>] [-SeniorityIndex
<Int32>] [-SimpleDisplayName <String>] [-Universal
<SwitchParameter>] [-WhatIf [<SwitchParameter>]]
[-WindowsEmailAddress <SmtpAddress>]

Параметры

Параметр	Обязательный	Тип	Описание
Identity	Обязательный	Microsoft.Exchange.Configuration.Tasks.GroupIdParameter	Параметр Identity определяет объект, который необходимо изменить. Параметр Identity для группы может принимать только одно из следующих значений: различающееся имя (DN) каноническое имя идентификатор GUID имя краткое имя
BypassSecurityGroupManagerCheck	Необязательный	System.Management.Automation.SwitchParameter	Параметр BypassSecurityGroupManagerCheck указывает, пропускать ли контроль и проверки безопасности, если указанная группа является контролируемой группой рассылки.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm можно использовать для отключения запросов на подтверждение, которые отображаются по умолчанию при запуске командлета. Чтобы отключить запросы на подтверждение, используйте синтаксис `-Confirm:$False`. В синтаксисе необходимо использовать двоеточие ( `:` ).
DisplayName	Необязательный	System.String	Параметр DisplayName указывает имя группы в консоли управления Exchange и в глобальном списке адресов Exchange. Этот параметр важен только в том случае, если группа является почтовой.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.
IgnoreDefaultScope	Необязательный	System.Management.Automation.SwitchParameter	Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения. При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога. В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью идентификатора GUID, не допускаются.
IsHierarchicalGroup	Необязательный	System.Boolean	Параметр IsHierarchicalGroup указывает, является ли группа частью иерархической адресной книги. Этот параметр принимает значения `$true` или `$false`. По умолчанию параметр имеет значение `$false`.
ManagedBy	Необязательный	Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter[]	Параметр ManagedBy указывает имя пользователя, группы или контакта, которое отображается на вкладке Управляется объекта Служба каталогов Active Directory. Для этого параметра можно использовать следующие значения: Различающееся имя Каноническое имя GUID Имя Отображаемое имя
Name	Необязательный	System.String	Параметр Name указывает имя группы. Параметр Name указывает имя группы в оснастке Служба каталогов Active Directory «Пользователи и компьютеры», а также в поле Имя группы на консоли управления Exchange, если для группы включена поддержка почты.
Notes	Необязательный	System.String	Параметр Notes указывает примечания, которые описывают цель данной группы.
PhoneticDisplayName	Необязательный	System.String	Параметр PhoneticDisplayName определяет фонетическую транскрипцию параметра DisplayName. Максимальная длина этого параметра составляет 255 знаков. Дополнительные сведения о параметре PhoneticDisplayName и автоматическом распознавании речи см. в разделе Общие сведения о поиске в каталоге автоматического распознавания речи.
SeniorityIndex	Необязательный	System.Int32	Параметр SeniorityIndex указывает порядок отображения группы в иерархической адресной книге. Группа со значением 2 будет отображаться в адресной книге выше, чем группа со значением 1.
SimpleDisplayName	Необязательный	System.String	Параметр SimpleDisplayName используется для вывода альтернативного описания объекта, когда разрешен только ограниченный набор знаков. Этот ограниченный набор знаков включает знаки с кодами ASCII от 26 до 126 включительно. Параметр SimpleDisplayName имеет значение только для объектов, поддерживающих почту.
Universal	Необязательный	System.Management.Automation.SwitchParameter	Параметр Universal изменяет область группы с `global` или `domain local` на `universal`.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.
WindowsEmailAddress	Необязательный	Microsoft.Exchange.Data.SmtpAddress	Параметр WindowsEmailAddress указывает значение поля Электронная почта объекта Служба каталогов Active Directory.

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

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

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Группа рассылки» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

Исключения

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

Примеры

ПРИМЕР 1

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

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

	Скопировать код
Set-Group -Identity "Legal Department" -Universal -Notes "verified"

ПРИМЕР 2

В этом примере указывается, что группа «Human Resources» является иерархической и будет отображаться в своей иерархии последней, так как ее индекс равен 1.

	Скопировать код
Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1