Alterar uma Entrada de Função

Aplica-se a: Exchange Server 2010

Tópico modificado em: 2009-09-21

Cada entrada de função de gerenciamento em uma função de gerenciamento representa um único cmdlet. Adicionando parâmetros a uma função de entrada ou removendo parâmetros dela, a qual é adicionada a uma função de gerenciamento, você controla se eles estão disponíveis no cmdlet. Para mais informações sobre as entradas de função de gerenciamento no Microsoft Exchange Server 2010, consulte Entendendo as Funções de Gerenciamento.

Não é possível modificar as entradas de função em funções de gerenciamento internas.

É preciso usar o Shell para adicionar ou remover parâmetros de uma entrada de função.

Dica

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

Aviso

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

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

Pré-requisitos

• Para adicionar parâmetros a uma entrada de função, é necessário que os parâmetros existam na entrada de função na função pai.
• Os parâmetros também devem existir no cmdlet que você especificar.
• Para remover parâmetros de uma entrada da função, é necessário que os parâmetros não existam nas entradas da função de qualquer função filha. Você deve remover os parâmetros das entradas de função das funções filhas. Use o procedimento "Usar o Shell para remover um ou mais parâmetros de uma entrada de função" mais adiante neste tópico para remover os parâmetros das entradas de função de todas as funções filhas.

O que Você Deseja Fazer?

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

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

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

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

  Dica

  O EMC não pode ser usado para alterar uma entrada de função.

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

Para executar este procedimento, você precisa de permissões. Para ver de que permissões você precisa, consulte o Entrada "Entradas da função de gerenciamento" no tópico Função de Gerenciamento de Permissões.

Para adicionar parâmetros a uma entrada de função, é preciso especificar os parâmetros que deseja adicionar usando o parâmetro Parameters. É preciso 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

Esse exemplo adiciona os parâmetros EmailAddresses e Type ao cmdlet Set-Mailbox na função Administradores de Destinatários.

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

Para informações detalhadas de sintaxes e de parâmetros, consulte Set-ManagementRoleEntry.

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

Para executar este procedimento, você precisa de permissões. Para ver de que permissões você precisa, consulte o Entrada "Entradas da função de gerenciamento" no tópico Função de Gerenciamento de Permissões.

Para remover parâmetros de uma entrada de função, é preciso especificar os parâmetros que deseja remover usando o parâmetro Parameters. É preciso 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

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

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

Para informações detalhadas de sintaxes e de parâmetros, consulte Set-ManagementRoleEntry.

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

Para executar este procedimento, você precisa de permissões. Para ver de que permissões você precisa, consulte o Entrada "Entradas da função de gerenciamento" no tópico Função de Gerenciamento de Permissões.

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

A remoção de todos os parâmetros de uma entrada de função é mais útil quando se quer disponibilizar apenas alguns parâmetros em um cmdlet e excluir todos os outros parâmetros. Se não quiser que a função tenha acesso a um cmdlet, remova a entrada de função associada da função por completo 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 

Esse exemplo remove todos os parâmetros do cmdlet Set-CasMailbox na função Administradores de Destinatários.

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

Para informações detalhadas de sintaxes e de parâmetros, consulte Set-ManagementRoleEntry.

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

Para executar este procedimento, você precisa de permissões. Para ver de que permissões você precisa, consulte o Entrada "Entradas da função de gerenciamento" no tópico Função de Gerenciamento de Permissões.

Se quiser incluir apenas um conjunto específico de parâmetros a uma entrada de função, especifique o parâmetro Parameters apenas. Não inclua os parâmetros AddParameter ou RemoveParameter. Ao especificar apenas o parâmetro Parameters, só os parâmetros que você especificar no comando serã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...>

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

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

Para informações detalhadas de sintaxes e de parâmetros, consulte Set-ManagementRoleEntry.