Adicionar uma entrada de função a uma função
Aplica-se a: Exchange Server 2013
Para conceder acesso a um cmdlet, é preciso adicionar a entrada de função de gerenciamento associada a uma função de gerenciamento. Depois de adicionar a entrada de função a uma função, os usuários aos quais a função for atribuída poderão acessar esse 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.
Não é possível adicionar entradas de função para funções internas. Se você desejar personalizar funções, crie uma nova função. Para obter mais informações sobre como criar uma nova função, consulte Criar uma função.
Observação
Este tópico não discute como adicionar entradas de função de gerenciamento sem escopo a uma função de gerenciamento sem escopo. Para obter mais informações sobre como adicionar entradas de função sem escopo, consulte Adicionar uma entrada de função a uma função de nível superior sem escopo.
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.
Uma entrada de função que você deseje adicionar a uma função de gerenciamento precisa existir na função de gerenciamento pai imediata da função.
Este tópico faz uso de canalização. Para obter mais informações sobre pipelining, consulte about_Pipelines.
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.
Adicionar uma única entrada de função de uma função pai
Você pode adicionar uma entrada de função a uma função exatamente como ela aparece na função pai usando a sintaxe a seguir.
Add-ManagementRoleEntry <child role name>\<cmdlet>
Este exemplo adiciona o cmdlet de Set-Mailbox à função de Administradores de Destinatários.
Add-ManagementRoleEntry "Recipient Administrators\Set-Mailbox"
Esse comando verifica a função pai, e se a entrada de função existir, é adicionada à função filha. Se a entrada de função já existir na função filho, você poderá incluir o parâmetro Overwrite para substituir a entrada de função existente.
Para informações detalhadas de sintaxes e de parâmetros, consulte Add-ManagementRoleEntry.
Adicionar uma única entrada de função de uma função pai e incluir apenas parâmetros específicos
Para adicionar uma entrada de função de uma função pai, porém incluindo apenas parâmetros específicos da entrada de função na função filha, use a sintaxe a seguir.
Add-ManagementRoleEntry <child role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...>
Este exemplo adiciona o cmdlet Set-Mailbox à função Help Desk, mas inclui apenas os parâmetros DisplayName e EmailAddresses na entrada na função filho.
Add-ManagementRoleEntry "Help Desk\Set-Mailbox" -Parameters DisplayName, EmailAddresses
Esse comando verifica a função pai, e se a entrada de função existir, é adicionada à função filha. Se a entrada de função já existir na função filho, você poderá incluir o parâmetro Overwrite para substituir a entrada de função existente.
Para informações detalhadas de sintaxes e de parâmetros, consulte Add-ManagementRoleEntry.
Adicionar várias entradas de função de uma função de pai
Para adicionar mais de uma entrada de função a uma função, é preciso obter uma lista de entradas de função que existam na função pai que você deseja adicionar à função filha, para em seguida adicioná-las à função filha. Para isso, obtenha a lista de entradas de função em uma função pai usando o cmdlet Get-ManagementRoleEntry. Canalize a saída do cmdlet Get-ManagementRoleEntry para o cmdlet Add-ManagementRoleEntry. Para recuperar várias entradas de função, você precisa usar o caractere curinga (*).
Para adicionar várias entradas de uma função de pai a uma função filha, use a sintaxe a seguir.
Get-ManagementRoleEntry <parent role name>\*<partial cmdlet name>* | Add-ManagementRoleEntry -Role <child role name>
Este exemplo adiciona todas as entradas de função que contêm a cadeia de caracteres Mailbox no nome do cmdlet na função pai dos Destinatários de Email à função filho de Destinatários do Seattle Mail.
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Seattle Mail Recipients"
Se as entradas de função já existirem na função filho, você poderá incluir o parâmetro Overwrite para substituir as entradas de função existentes.
Para obter mais informações sobre como recuperar uma lista de entradas de função de gerenciamento, consulte Exibir entradas de função.
Para obter a sintaxe detalhada e informações sobre o parâmetro, consulte Get-ManagementRoleEntry e Add-ManagementRoleEntry.