Get-ManagementRole
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet Get-ManagementRole para exibir as funções de gerenciamento criadas em sua organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-GetChildren]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>] Get-ManagementRole
[-Identity] <RoleIdParameter>
[-Recurse]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>] Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Cmdlet <String>]
[-CmdletParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>] Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Script <String>]
[-ScriptParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>] Description
Você pode exibir funções de gerenciamento de várias formas: a partir da listagem de todas as funções em sua organização à listagem apenas de funções filhas de uma função pai especificada. Você pode exibir os detalhes de uma função especificada, canalizando a saída do cmdlet Get-ManagementRole para o cmdlet Format-List.
Para obter mais informações sobre funções de gerenciamento, consulte Noções básicas sobre funções de gerenciamento.
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-ManagementRoleEste exemplo lista todas as funções criadas em sua organização.
Exemplo 2
Get-ManagementRole "Mail Recipients" -RecurseEste exemplo lista todas as funções filhas da função de gerenciamento destinatários de email. O comando executa uma consulta recursiva de todas as funções filhas da função pai especificada. Esta consulta recursiva encontra cada função filha da filha imediata do pai da última função filha na hierarquia. Em uma lista recursiva, a função pai também é retornada na lista.
Exemplo 3
Get-ManagementRole -CmdletParameters Identity, DatabaseEste exemplo lista todas as funções que contenham os parâmetros Identity e Database. As funções que contêm apenas um parâmetro ou outro não são retornadas.
Exemplo 4
Get-ManagementRole -RoleType UnScopedTopLevelEste exemplo lista todas as funções que possuam um tipo de UnScopedTopLevel. Essas funções contêm scripts personalizados ou cmdlets que não são do Exchange.
Exemplo 5
Get-ManagementRole "Transport Rules" | Format-List Name, RoleTypeEste exemplo recupera apenas a função Regras de Transporte e permite passar a saída do cmdlet Get-ManagementRole para o cmdlet Format-List. O cmdlet Format-List mostra apenas as propriedadesName e RoleType da função Regras de Transporte. Para obter mais informações sobre pipelining e o cmdlet Format-List, consulte Sobre Pipelines e Trabalhando com saída de comando.
Exemplo 6
Get-ManagementRole "Mail Recipients" -GetChildrenEste exemplo lista a filha imediata da função de destinatários de email. Apenas as funções filhas que contenham a função de destinatários de email como sua função pai são retornadas. A função de destinatários de email não são retornadas na lista.
Parâmetros
-Cmdlet
O parâmetro Cmdlet retorna uma lista de todas as funções que incluem o cmdlet especificado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-CmdletParameters
O parâmetro CmdletParameters retorna uma lista de todas as funções que incluem o parâmetro ou parâmetros especificados. Para especificar mais de um parâmetro, separe cada parâmetro com uma vírgula. Se você especificar vários parâmetros, só as funções que incluem todos os parâmetros especificados são retornadas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-DomainController
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GetChildren
O parâmetro GetChildren recupera uma lista de todas as funções que foram criadas baseadas na função pai especificada no parâmetro Identity. Não é preciso especificar um valor com essa opção.
Somente as funções filho imediatas da função pai são incluídas nos resultados.
Você só pode usar essa opção com os parâmetros Identity e RoleType.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Identity
O parâmetro Identity especifica a função que você deseja exibir. Se a função que você deseja exibir contiver espaços, coloque-a entre aspas ("). Você pode usar o caractere curinga (*) e um nome de função parcial para encontrar várias funções.
| Type: | RoleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Recurse
O parâmetro Recurse recupera uma lista de todas as funções que foram criadas baseadas na função pai especificada no parâmetro Identity. Não é preciso especificar um valor com essa opção.
A função especificada no parâmetro Identity, suas funções filhas e seus filhos são retornados.
Você só pode usar essa opção com os parâmetros Identity e RoleType.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-RoleType
O parâmetro RoleType retorna uma lista de funções que correspondam ao tipo de função especificada. Para obter uma lista de tipos de função válidos, consulte Noções básicas sobre funções de gerenciamento.
| Type: | RoleType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Script
O parâmetro Script retorna uma lista de todas as funções que incluem o script especificado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-ScriptParameters
O parâmetro ScriptParameters retorna uma lista de todas as funções que incluem o parâmetro ou parâmetros especificados. Para especificar mais de um parâmetro, separe cada parâmetro com uma vírgula. Se você especificar vários parâmetros, só as funções que incluem todos os parâmetros especificados são retornadas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.