Exibir uma função
Aplica-se a: Exchange Server 2013
As funções de gerenciamento podem ser listadas de várias maneiras, dependendo das informações que você desejar. Por exemplo, você pode escolher retornar apenas as funções de um tipo específico, funções que contenham apenas cmdlets e parâmetros específicos ou exibir os detalhes de uma função de gerenciamento específica. Para obter mais informações sobre funções de gerenciamento no Microsoft Exchange Server 2013, confira Noções básicas sobre funções de gerenciamento.
Se quiser exibir uma lista de todas as entradas de função de gerenciamento em uma função, consulte Exibir entradas de função.
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.
Este tópico usa pipelining e os cmdlets Format-List e Format-Table. Para mais informações sobre esses conceitos, consulte os seguintes tópicos:
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.
Exibir uma função de gerenciamento específica
Você pode exibir os detalhes de uma função específica recuperando uma função específica usando o cmdlet Get-ManagementRole e canalizando a saída para o cmdlet Format-List.
Para exibir detalhes de uma função específica, use a sintaxe a seguir.
Get-ManagementRole <role name> | Format-List
Este exemplo recupera os detalhes sobre a função de gerenciamento de Destinatários de Email.
Get-ManagementRole "Mail Recipients" | Format-List
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.
Listar todas as funções de gerenciamento
Você pode exibir uma lista de todas as funções de gerenciamento em sua organização executando o cmdlet Get-ManagementRole. Por padrão, o nome e o tipo de cada função são incluídos nos resultados.
Este exemplo retorna uma lista de todas as funções em sua organização.
Get-ManagementRole
Para retornar uma lista de propriedades específicas para todas as funções em sua organização, você pode canalizar os resultados do cmdlet Format-Table e especificar as propriedades que quiser na lista de resultados. Use a sintaxe a seguir.
Get-ManagementRole | Format-Table <property 1>, <property 2...>
Este exemplo retorna uma lista de todas as funções em sua organização e inclui a propriedade Name e qualquer propriedade com a palavra Implicit no começo do nome da propriedade.
Get-ManagementRole | Format-Table Name, Implicit*
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.
Funções de gerenciamento de lista que contêm um cmdlet específico
Você pode retornar uma lista de funções que contenham um cmdlet especificado usando o parâmetro Cmdlet no cmdlet Get-ManagementRole.
Para retornar uma lista de funções que contenham o cmdlet especificado, use a sintaxe a seguir.
Get-ManagementRole -Cmdlet <cmdlet>
Este exemplo retorna uma lista de funções que contenham o cmdlet New-Mailbox.
Get-ManagementRole -Cmdlet New-Mailbox
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.
Listar funções de gerenciamento que contenham um parâmetro específico
Você pode retornar uma lista de funções que contenham um ou mais parâmetros especificados usando o parâmetro CmdletParameters no cmdlet Get-ManagementRole. Somente funções que contenham todos os parâmetros que você especificar serão retornadas.
Ao usar o parâmetro CmdletParameters , você pode optar por incluir o parâmetro Cmdlet . Se você incluir o parâmetro Cmdlet , somente as funções que contêm os parâmetros especificados no cmdlet especificado serão retornadas. Se você não incluir o parâmetro Cmdlet , as funções que contêm os parâmetros especificados, independentemente do cmdlet em que estão, serão retornadas.
Para retornar uma lista de funções que contenham os parâmetros que você especificar, use a sintaxe a seguir.
Get-ManagementRole [-Cmdlet <cmdlet>] -CmdletParameters <parameter 1>, <parameter 2...>
Este exemplo retorna uma lista de funções que contêm os parâmetros Banco de Dados e Servidor , independentemente dos cmdlets em que eles existem.
Get-ManagementRole -CmdletParameters Database, Server
Este exemplo retorna uma lista de funções em que o parâmetro EmailAddresses existe apenas no cmdlet Set-Mailbox .
Get-ManagementRole -Cmdlet Set-Mailbox -CmdletParameters EmailAddresses
Você também pode usar o caractere curinga (*) com os parâmetros Cmdlet ou CmdletParameters para corresponder a cmdlet parcial ou nomes de parâmetro.
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.
Listar as funções de gerenciamento de um tipo de função específico
Você pode retornar uma lista de funções baseadas em um tipo de função especificado usando o parâmetro RoleType no cmdlet Get-ManagementRole.
Para retornar uma lista de funções que correspondam ao tipo de função que você especificou, use a sintaxe a seguir.
Get-ManagementRole -RoleType <roletype>
Este exemplo retorna uma lista de funções com base no tipo de UmMailboxes
função.
Get-ManagementRole -RoleType UmMailboxes
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.
Listar as funções filhas imediatas de uma função pai
Você pode retornar uma lista de funções que sejam filhas imediatas da função pai especificada usando o parâmetro GetChildren no cmdlet Get-ManagementRole. Somente funções que contenham a função que você especificar como função pai serão retornadas.
Para retornar uma lista de funções filhas imediatas de uma função pai, use a sintaxe a seguir.
Get-ManagementRole <parent role name> -GetChildren
Este exemplo retorna uma lista de filhas imediatas da função Recuperação de Desastres.
Get-ManagementRole "Disaster Recovery" -GetChildren
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.
Listar todas as funções filhas abaixo de uma função pai
Você pode retornar uma lista de toda a cadeia de funções de uma função pai especificada para a última função filha usando o parâmetro Recurse no cmdlet Get-ManagementRole. O parâmetro Recurse informa ao cmdlet Get-ManagementRole para se repetir em todas as relações pai e filho que encontrar até atingir a última função filho. A função pai está incluída na lista que é retornada.
Este exemplo retorna uma lista de todas as funções filhas de uma função pai.
Get-ManagementRole <parent role name> -Recurse
Este exemplo retorna todas as funções filhas da função Destinatários de Email.
Get-ManagementRole "Mail Recipients" -Recurse
Para informações detalhadas de sintaxes e de parâmetros, consulte Get-ManagementRole.