Compartilhar via


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-ManagementRole

Este exemplo lista todas as funções criadas em sua organização.

Exemplo 2

Get-ManagementRole "Mail Recipients" -Recurse

Este 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, Database

Este 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 UnScopedTopLevel

Este 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, RoleType

Este 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" -GetChildren

Este 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.