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

Последнее изменение раздела: 2011-03-19

Используйте командлет Set-ManagementRoleEntry для изменения доступных параметров в существующей записи роли управления.

Синтаксис


`Set-ManagementRoleEntry -Identity <RoleEntryIdParameter> [-AddParameter <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-Parameters <String[]>] [-RemoveParameter <SwitchParameter>] [-UnScopedTopLevel <SwitchParameter>] [-WhatIf [<SwitchParameter>]]`

Параметры

Параметр	Обязательный	Тип	Описание
Identity	Обязательный	Microsoft.Exchange.Configuration.Tasks.RoleEntryIdParameter	Параметр Identity указывает запись роли, которая будет изменена. Необходимо указать значение параметра Identity в формате <роль управления>\<имя записи роли>, например ExampleRole\Set-Mailbox. Дополнительные сведения о работе записей ролей управления см. в разделе Общие сведения о ролях управления. Если имя роли содержит пробелы, заключите его в кавычки (").
AddParameter	Необязательный	System.Management.Automation.SwitchParameter	Параметр AddParameter добавляет указанные параметры к указанной записи роли. Используйте параметр Parameters, чтобы указать параметры для добавления. Нельзя использовать параметр AddParameter вместе с параметром RemoveParameter.
Confirm	Необязательный	System.Management.Automation.SwitchParameter
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn
Force	Необязательный	System.Management.Automation.SwitchParameter
Parameters	Необязательный	System.String[]	Параметр Parameters указывает параметры, которые будут добавлены к записи роли или удалены из нее. Параметр Parameters имеет следующие режимы: При использовании параметра AddParameter указываемые параметры добавляются к записи роли. При использовании параметра RemoveParameter указываемые параметры удаляются из записи роли. Если параметры AddParameter и RemoveParameter не используются, только указываемые параметры включаются в запись роли. Если задано значение `$Null`, а параметры AddParameter и RemoveParameter не используются, все параметры в записи роли удаляются. Можно указать несколько параметров, разделенных запятыми.
RemoveParameter	Необязательный	System.Management.Automation.SwitchParameter	Параметр RemoveParameter удаляет указанные параметры из записи указанной роли. Используйте параметр Parameters, чтобы указать удаляемые параметры. Параметр RemoveParameter нельзя использовать вместе с параметром AddParameter.
UnScopedTopLevel	Необязательный	System.Management.Automation.SwitchParameter	Переключатель UnScopedTopLevel следует использовать, когда нужно изменить запись роли в роли высокого уровня с незаданной областью.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter

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

Командлет Set-ManagementRoleEntry изменяет доступные параметры в существующей записи роли управления. Если нужно добавить параметры к записи роли, они должны существовать в записи роли родительской роли управления. Если нужно удалить параметры из записи роли, не должно быть записей роли в дочерних ролях, наследующие эти параметры из записи роли, которую нужно изменить. Нельзя изменить записи роли, связанные со встроенными ролями.

Дополнительные сведения о записях ролей управления см. в разделе Общие сведения о ролях управления.

Запись «Записи ролей управления» в разделе Разрешения управления ролями.

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

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

Ошибки

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

Примеры

ПРИМЕР 1

В этом примере удаляются параметры Anr и Database из записи роли Get-Mailbox в роли Help Desk Personnel.

	Скопировать код
Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters Anr, Database -RemoveParameter

ПРИМЕР 2

В этом примере возвращается список записей в роли Help Desk Personnel и добавляется переключатель WhatIf к каждой записи роли с помощью командлета Set-ManagementRoleEntry.

	Скопировать код
Get-ManagementRoleEntry "Help Desk Personnel\*" \| Set-ManagementRoleEntry -Parameters WhatIf -AddParameter

ПРИМЕР 3

В этом примере добавляются параметры DisplayName и ForwardingAddress к записи роли Set-Mailbox в роли Tier 1 Help Desk, а все другие параметры удаляются из записи роли.

	Скопировать код
Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters DisplayName, ForwardingAddress

ПРИМЕР 4

В этом примере добавляется параметр Location к настраиваемому сценарию MailboxAudit в роли высокого уровня с незаданной областью IT Scripts.

	Скопировать код
Set-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Location -AddParameter -UnScopedTopLevel