С помощью командлета 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>] |
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.GroupIdParameter |
Параметр Identity определяет объект, который необходимо изменить. Параметр Identity для группы может принимать только одно из следующих значений:
Параметр 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. Для этого параметра доступны следующие значения:
|
Имя |
Дополнительно |
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 изменяет область группы с
|
WindowsEmailAddress |
Дополнительно |
Microsoft.Exchange.Data.SmtpAddress |
Параметр WindowsEmailAddress указывает значение поля Электронная почта объекта Active Directory. |
Подробное описание
С помощью командлета 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, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Пример
В следующем примере показано, как с помощью командлета Set-Group применить следующие изменения для существующей глобальной группы безопасности с именем «Legal Department»:
- Изменение области действия группы на универсальную
- Добавление параметра «Notes» со значением
verified
Копировать код | |
---|---|
Set-Group -Identity "Legal Department" -Universal -Notes "verified" |