Изменение записи ролиChange a role entry

Применимо к: Exchange Server 2013Applies to: Exchange Server 2013

Каждая запись роли управления в роли управления представляет собой отдельный командлет. При добавлении записи роли в роль управления можно регулировать параметры, доступные в этом командлете, путем добавления параметров в эту запись роли или их удаления. Дополнительные сведения о записях ролей управления в Microsoft Exchange Server 2013 см. в разделе Общие сведения о ролях управления.Each management role entry on a management role represents a single cmdlet. By adding parameters to or removing parameters from a role entry, which is then added to a management role, you control whether those parameters are available on that cmdlet. For more information about management role entries in Microsoft Exchange Server 2013, see Understanding management roles.

Изменение записей роли во встроенных ролях управления невозможно.You can't modify the role entries on built-in management roles.

Примечание

В этом разделе не содержатся сведения по изменению записей роли управления с незаданной областью в роли управления с незаданной областью. Дополнительные сведения об изменении записей роли управления с незаданной областью см. в разделе Создание роли.This topic doesn't discuss how to modify unscoped management role entries on an unscoped management role. For more information about how to modify unscoped role entries, see Create a role.

Предупреждение

Чтобы добавить или удалить параметры из записи роли, необходимо использовать параметры AddParameter или RemoveParameter . Если опустить параметр AddParameter или RemoveParameter при запуске командлета Set-ManagementRoleEntry , в записи роли будут включены только параметры, задать с помощью параметра параметров . Все другие параметры записи роли будут удалены.To add or remove parameters from a role entry, you must use the AddParameter or RemoveParameter parameters. If you omit the AddParameter or RemoveParameter parameter when you run the Set-ManagementRoleEntry cmdlet, only the parameters you specify using the Parameters parameter will be included in the role entry. All other parameters on the role entry will be removed.

Необходимы сведения о других задачах управления, связанных с ролями? см. в разделе Дополнительные разрешения.Looking for other management tasks related to roles? Check out Advanced permissions.

Что нужно знать перед началом работыWhat do you need to know before you begin?

  • Предполагаемое время для завершения каждой процедуры: 5 минутEstimated time to complete each procedure: 5 minutes

  • Для выполнения этих процедур необходимы соответствующие разрешения. Сведения о необходимых разрешениях см. в статье Запись "Роли управления" в разделе Разрешения управления ролями.You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Management roles" entry in the Role management permissions topic.

  • Для выполнения этих процедур необходимо использовать командную консоль Exchange.You must use the Shell to perform these procedures.

  • При необходимости добавить параметры к записи роли добавляемые параметры должны существовать в записи роли родительской роли. Эти параметры также должны существовать в указанном командлете.If you want to add parameters to a role entry, the parameters you add must exist in the role entry in the parent role. The parameters must also exist on the cmdlet you specify.

  • Чтобы удалить параметры из записи роли, удаляемые параметры не должны существовать в записи роли любой из дочерних ролей. Необходимо удалить эти параметры из записей роли дочерних ролей. Чтобы удалить параметры из записей роли всех дочерних ролей, используйте процедуру "Использование командной консоли Exchange для удаления одного или нескольких параметров из записи роли", описанную ниже в этом разделе.If you want to remove parameters from a role entry, the parameters you remove can't exist in the role entries of any child roles. You must remove the parameters from the role entries of the child roles. Use the "Use the Shell to remove one or more parameters from a role entry" procedure later in this topic to remove the parameters from the role entries of all child roles.

  • Сочетания клавиш для процедур, описанных в этой статье, приведены в статье Сочетания клавиш в Центре администрирования Exchange.For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Совет

Возникли проблемы? Обращение за помощью в форумах Exchange. Посетите форумы Exchange Server, Exchange Onlineили Exchange Online Protection.Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Server, Exchange Online, or Exchange Online Protection.

Что необходимо сделать?What do you want to do?

Использование командной консоли Exchange для добавления одного или нескольких параметров для записи ролиUse the Shell to add one or more parameters to a role entry

Чтобы добавить параметры к записи роли, необходимо указать эти параметры с помощью параметра Parameters. Затем требуется указать параметр AddParameter, чтобы указать на необходимость процедуры добавления.To add parameters to a role entry, you need to specify the parameters you want to add using the Parameters parameter. You then need to specify the AddParameter parameter to indicate that you want to perform an add operation.

Чтобы добавить параметры к записи роли, используйте следующий синтаксис.To add parameters to a role entry, use the following syntax.

    Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -AddParameter

В этом примере добавляется параметры EmailAddresses и Тип в командлет Set-Mailbox в роли администраторов получателей.This example adds the EmailAddresses and Type parameters to the Set-Mailbox cmdlet on the Recipient Administrators role.

    Set-ManagementRoleEntry "Recipient Administrators\Set-Mailbox" -Parameters EmailAddresses, Type -AddParameter

Дополнительные сведения о синтаксисе и параметрах см. в разделе Set-ManagementRoleEntry.For detailed syntax and parameter information, see Set-ManagementRoleEntry.

Использование командной консоли Exchange для удаления одного или нескольких параметров из записи ролиUse the Shell to remove one or more parameters from a role entry

Чтобы удалить параметры из записи роли, необходимо указать эти параметры с помощью параметра Parameters. Затем требуется указать параметр RemoveParameter, чтобы указать на необходимость процедуры удаления.To remove parameters from a role entry, you need to specify the parameters you want to remove using the Parameters parameter. You then need to specify the RemoveParameter parameter to indicate that you want to perform a remove operation.

Чтобы удалить параметры из записи роли, используйте следующий синтаксис.To remove parameters from a role entry, use the following syntax.

    Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -RemoveParameter

В этом примере удаляется параметры порта, ProtocolLoggingLevelи SmartHostAuthMechanism из командлета Set-SendConnector в роли администраторов серверов уровня 1.This example removes the Port, ProtocolLoggingLevel, and SmartHostAuthMechanism parameters from the Set-SendConnector cmdlet on the Tier 1 Server Administrators role.

    Set-ManagementRoleEntry "Tier 1 Server Administrators\Set-SendConnector" -Parameters Port, ProtocolLoggingLevel, SmartHostAuthMechanism -RemoveParameter

Дополнительные сведения о синтаксисе и параметрах см. в разделе Set-ManagementRoleEntry.For detailed syntax and parameter information, see Set-ManagementRoleEntry.

Использование командной консоли Exchange для удаления всех параметров из записи ролиUse the Shell to remove all parameters from a role entry

Чтобы удалить все параметры из записи роли, необходимо указать значение $Null на параметр Parameters . Включить параметр RemoveParameters не требуется.To remove all the parameters from a role entry, you need to specify the value $Null on the Parameters parameter. You don't need to include the RemoveParameters parameter.

Удаление всех параметров из записи роли наиболее полезно при необходимости сделать доступными в командлете только определенные параметры и исключить все остальные параметры. Чтобы запретить для роли доступ к командлету, полностью удалите из роли связанную запись роли вместо удаления только параметров. Дополнительные сведения о способе удаления записи роли из роли см. в разделе Удаление записи роли из роли.Removing all the parameters from a role entry is most useful when you want to make only a few parameters available on a cmdlet and exclude all of the other parameters. If you don't want the role to have access to a cmdlet, remove the associated role entry from the role completely instead of just removing the parameters. For more information about how to remove a role entry from a role, see Remove a role entry from a role.

Предупреждение

Операции удаления отменить невозможно. Если из записи роли ошибочно удалены все параметры, их можно повторно добавить вручную.You can't undo remove operations. If you mistakenly remove all the parameters from a role entry, you must add them again manually.

Чтобы удалить все параметры из записи роли, используйте следующий синтаксис.To remove all the parameters from a role entry, use the following syntax.

    Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters $Null 

В этом примере удаляются все параметры из командлета Set-CASMailbox в роли администраторов получателя.This example removes all the parameters from the Set-CASMailbox cmdlet on the Recipient Administrators role.

    Set-ManagementRoleEntry "Recipient Administrators\Set-CASMailbox" -Parameters $Null 

Дополнительные сведения о синтаксисе и параметрах см. в разделе Set-ManagementRoleEntry.For detailed syntax and parameter information, see Set-ManagementRoleEntry.

Использование командной консоли Exchange для применения определенного набора параметровUse the Shell to apply a specific set of parameters

Чтобы включить в запись роли только определенный набор параметров, укажите только параметр Parameters. Не добавляйте параметры AddParameter или RemoveParameter. При указании только параметра Parameters в запись роли включаются только параметры, указанные в команде. Все другие параметры удаляются.If you want only a specific set of parameters to be included on a role entry, specify the Parameters parameter only. Don't include the AddParameter or RemoveParameter parameters. When you specify only the Parameters parameter, only the parameters you specify in the command are included on the role entry. All other parameters are removed.

Чтобы указать определенный набор параметров, используйте следующий синтаксис.To specify a specific set of parameters, use the following syntax.

    Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...>

В этом примере включает в себя только Identity, DisplayName, MissedCallNotificationEnabledи PersonalAuthAttendantEnabled параметров в командлете Set-UMMailbox в роли получателей почты Сиэтл.This example includes only the Identity, DisplayName, MissedCallNotificationEnabled, and PersonalAuthAttendantEnabled parameters on the Set-UMMailbox cmdlet on the Seattle Mail Recipients role.

    Set-ManagementRoleEntry "Seattle Mail Recipients\Set-UMMailbox" -Parameters Identity, DisplayName, MissedCallNotificationEnabled, PersonalAutoAttendantEnabled

Дополнительные сведения о синтаксисе и параметрах см. в разделе Set-ManagementRoleEntry.For detailed syntax and parameter information, see Set-ManagementRoleEntry.