Alterar uma entrada de função

Aplica-se a: Exchange Server 2013

Cada entrada de função de gerenciamento em uma função de gerenciamento representa um único cmdlet. Ao adicionar parâmetros ou remover parâmetros de uma entrada de função, que é adicionada a uma função de gerenciamento, você controla se esses parâmetros estão disponíveis nesse cmdlet. Para obter mais informações sobre as entradas de função de gerenciamento no Microsoft Exchange Server 2013, consulte Noções básicas sobre funções de gerenciamento.

Você não pode modificar as entradas de função em funções de gerenciamento internas.

Observação

Este tópico não discute como modificar entradas de função de gerenciamento nãocopadas em uma função de gerenciamento nãocopada. Para obter mais informações sobre como modificar entradas de função nãocopadas, consulte Criar uma função.

Aviso

Para adicionar ou remover parâmetros de uma entrada de função, você deve usar os parâmetros AddParameter ou RemoveParameter . Se você omitir o parâmetro AddParameter ou RemoveParameter ao executar o cmdlet Set-ManagementRoleEntry , somente os parâmetros especificados usando o parâmetro Parameters serão incluídos na entrada de função. Todos os outros parâmetros na entrada de função serão removidos.

Procurando outras tarefas de gerenciamento relacionadas a funções? Consulte Permissões avançadas.

Do que você precisa saber para começar?

• Tempo estimado para concluir cada procedimento: 5 minutos

• Para executar este procedimento ou estes procedimentos, você precisa receber permissões. Para ver de que permissões você precisa, consulte o Entrada "funções de gerenciamento" no tópico Permissões de gerenciamento de função.

• Você deve usar o Shell para executar estes procedimentos.

• Se você quiser adicionar parâmetros a uma entrada de função, os parâmetros adicionados devem existir na entrada de função na função pai. Os parâmetros também devem existir no cmdlet especificado.

• Se você quiser remover parâmetros de uma entrada de função, os parâmetros removidos não poderão existir nas entradas de função de qualquer função filho. Você deve remover os parâmetros das entradas de função das funções filho. Use o procedimento "Usar o Shell para remover um ou mais parâmetros de uma entrada de função" posteriormente neste tópico para remover os parâmetros das entradas de função de todas as funções filho.

• Para informações sobre atalhos de teclado que possam se aplicar aos procedimentos neste tópico, confira Atalhos de teclado no Centro de Administração do Exchange.

Dica

Está com problemas? Peça ajuda nos fóruns do Exchange. Visite os fóruns no Exchange Server.

Usar o Shell Para adicionar um ou mais parâmetros a uma entrada de função

Para adicionar parâmetros a uma entrada de função, você precisa especificar os parâmetros que deseja adicionar usando o parâmetro Parâmetros . Em seguida, você precisa especificar o parâmetro AddParameter para indicar que deseja executar uma operação de adição.

Para adicionar parâmetros a uma entrada de função, use a sintaxe a seguir.

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

Este exemplo adiciona os parâmetros EmailAddresses e Type ao cmdlet Set-Mailbox na função Administradores do Destinatário.

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

Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.

Usar o Shell para remover um ou mais parâmetros de uma entrada de função

Para remover parâmetros de uma entrada de função, você precisa especificar os parâmetros que deseja remover usando o parâmetro Parâmetros . Em seguida, você precisa especificar o parâmetro RemoveParameter para indicar que deseja executar uma operação de remoção.

Para remover parâmetros de uma entrada de função, use a sintaxe a seguir.

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

Este exemplo remove os parâmetros Porta, ProtocolLoggingLevel e SmartHostAuthMechanism do cmdlet Set-SendConnector na função Administradores do Servidor de Camada 1.

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

Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.

Usar o Shell para remover todos os parâmetros de uma entrada de função

Para remover todos os parâmetros de uma entrada de função, você precisa especificar o valor $Null no parâmetro Parâmetros . Você não precisa incluir o parâmetro RemoveParameters .

Remover todos os parâmetros de uma entrada de função é mais útil quando você deseja disponibilizar apenas alguns parâmetros em um cmdlet e excluir todos os outros parâmetros. Se você não quiser que a função tenha acesso a um cmdlet, remova completamente a entrada de função associada da função em vez de apenas remover os parâmetros. Para mais informações sobre como remover uma entrada de função de uma função, consulte Remover uma entrada de função de uma função.

Aviso

As operações de remoção não podem ser desfeitas. Se você removeu por engano todos os parâmetros de uma entrada de função, será preciso adicioná-los manualmente outra vez.

Para remover todos os parâmetros de uma entrada de função, use a sintaxe a seguir.

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

Este exemplo remove todos os parâmetros do cmdlet Set-CASMailbox na função Administradores do Destinatário.

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

Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.

Usar o Shell para aplicar um conjunto específico de parâmetros

Se você quiser que apenas um conjunto específico de parâmetros seja incluído em uma entrada de função, especifique apenas o parâmetro Parâmetros . Não inclua os parâmetros AddParameter ou RemoveParameter . Quando você especifica apenas o parâmetro Parâmetros , apenas os parâmetros especificados no comando são incluídos na entrada de função. Todos os outros parâmetros são removidos.

Para especificar um conjunto específico de parâmetros, use a sintaxe a seguir.

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

Este exemplo inclui apenas os parâmetros Identity, DisplayName, MissedCallNotificationEnabled e PersonalAuthAttendantEnabled no cmdlet Set-UMMailbox na função Destinatários do Seattle Mail.

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

Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.