Adicionar uma Entrada de Função a uma Função
Aplica-se a: Exchange Server 2010 SP2, Exchange Server 2010 SP3
Tópico modificado em: 2011-03-19
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 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 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.
Você deve usar o Shell de adicionar entradas de função a uma função.
Dica
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 para uma Função de Nível Superior sem Escopo..
Procurando outras tarefas de gerenciamento relacionadas a funções? Consulte Gerenciando Permissões Avançadas.
Pré-requisitos
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 mais informações sobre pipeline, consulte Pipelining.
O que Você Deseja Fazer?
Adicionar uma única entrada de função de uma função pai
Adicionar uma única entrada de função de uma função pai e incluir apenas parâmetros específicos
Adicionar várias entradas de função de uma função de pai
Dica
O EMC não pode ser usado para adicionar uma entrada de função a uma função.
Adicionar uma única entrada de função de uma função pai
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.
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 filha, você pode 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 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 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 de Suporte Técnico, mas inclui apenas os parâmetros DisplayName e EmailAddresses na entrada da função filha.
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 filha, você pode 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 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 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 contenham a cadeia de caracteres Mailbox no nome do cmdlet na função pai Destinatários de Email à função filha Destinatários de Email de Seattle.
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Seattle Mail Recipients"
Se as entradas de função já existirem na função filha, você pode 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.
© 2010 Microsoft Corporation. Todos os direitos reservados.