Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет Update-RoleGroupMember позволяет изменять членов группы ролей управления.
Синтаксис
Update-RoleGroupMember -Identity
<RoleGroupIdParameter> [-BypassSecurityGroupManagerCheck
<SwitchParameter>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-Members
<MultiValuedProperty>] [-WhatIf
[<SwitchParameter>]]
|
Параметры
| Параметр | Обязательность | Тип | Описание |
|---|---|---|---|
|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.RoleGroupIdParameter |
Параметр Identity указывает группу ролей, членов которой необходимо изменить. Если имя группы ролей содержит пробелы, его необходимо заключить в кавычки ("). |
|
BypassSecurityGroupManagerCheck |
Необязательный |
System.Management.Automation.SwitchParameter |
Переключатель BypassSecurityGroupManagerCheck позволяет пользователю, который не был добавлен в свойство ManagedBy, изменять членов группы ролей. Пользователь должен являться членом группы ролей «Управление организацией» или быть назначенным напрямую или косвенно на роль управления ролями. |
|
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|
|
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|
|
Members |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр Members указывает почтовые ящики или универсальную группу безопасности, которые должны являться членами группы безопасности. Если имя участника содержит пробелы, его необходимо заключить в кавычки ("). Разделяйте членов запятыми. Внимание! Список, заданный с помощью параметра Members, переопределяет существующий список членов группы ролей. При необходимости добавления или удаления отдельных членов в группе ролей используйте командлеты Add-RoleGroupMember или Remove-RoleGroupMember. |
|
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Подробное описание
Командлет Update-RoleGroupMember позволяет заменить весь список членов группы ролей или выполнить программное добавление или удаление одновременно нескольких членов. Список членов, заданный с помощью параметра Members для этого командлета, заменяет список членов определенной группы ролей. Поэтому при использовании этого командлета убедитесь, что список членов группы ролей не был по ошибке перезаписан.
Командлеты Add-RoleGroupMember и Remove-RoleGroupMember позволяют добавлять и удалять членов группы ролей. Эти командлеты можно использовать совместно с другими, например с Get-Mailbox, чтобы добавить или удалить одновременно несколько членов без перезаписи всего списка.
Если свойство ManagedBy заполнено диспетчерами группы ролей, пользователь, обновляющий список членов группы ролей, должен являться диспетчером такой группы. В свою очередь, если пользователь является членом группы ролей «Управление организацией» или ему напрямую либо косвенно была назначена роль управления ролями, переключатель BypassSecurityGroupManagerCheck может использоваться для переопределения проверки управления группой безопасности.
Если группа ролей является связанной группой ролей, для изменения членов группы ролей можно использовать командлет Update-RoleGroupMember. В противном случае необходимо изменить членов внешней универсальной группы безопасности (USG), связанной с группой ролей. Для поиска другой уникальной группы безопасности, связанной с группой ролей, используйте командлет Get-RoleGroup.
Дополнительные сведения о группах ролей см. в разделе Общие сведения о группах ролей управления.
Запись «Группы ролей» в разделе Разрешения управления ролями.
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Примеры
ПРИМЕР 1
В этом примере для списка участников группы ролей администраторов получателей указаны имена Павел, Кристина, Марина и Виталий.
 Скопировать код |
|
|---|---|
Update-RoleGroupMember "Recipient Administrators" -Members "Mark", "Jane", "Mary", "Fred" |
|
ПРИМЕР 2
В этом примере для списка участников группы ролей администраторов получателей указаны имена Павел, Кристина, Марина и Виталий. Так как пользователь, запускающий команду, не был добавлен к свойству ManagedBy группы ролей, необходимо использовать переключатель BypassSecurityGroupManagerCheck. Пользователю назначается роль управления ролями, которая позволяет пользователю пропускать проверку диспетчера групп безопасности.
| Скопировать код |
|
|---|---|
Update-RoleGroupMember "Recipient Administrators" -Members "Mark", "Jane", "Mary", "Fred" -BypassSecurityGroupManagerCheck |
|