Get-ManagementRole
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
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.
Sintaxe
GetChildren
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-GetChildren]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Recurse
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-Recurse]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Identity
Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Cmdlet <String>]
[-CmdletParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Script
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 gestão, veja Compreender as funções de gestão.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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. Estas funções contêm scripts personalizados ou cmdlets não 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, veja About Pipelines and Working with command output (Acerca dos Pipelines e Trabalhar com a saída do 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro Cmdlet retorna uma lista de todas as funções que incluem o cmdlet especificado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CmdletParameters
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GetChildren
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
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.
Apenas as funções subordinadas imediatas da função principal são incluídas nos resultados.
Só pode utilizar este comutador com os parâmetros Identity e RoleType.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetChildren
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
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.
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | RoleIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetChildren
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Recurse
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Identity
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Script
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Recurse
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
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.
Só pode utilizar este comutador com os parâmetros Identity e RoleType.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Recurse
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RoleType
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
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ções válidos, veja Compreender as funções de gestão.
Propriedades do parâmetro
| Tipo: | RoleType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Script
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
O parâmetro Script retorna uma lista de todas as funções que incluem o script especificado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Script
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ScriptParameters
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformidade & de Segurança, Segurança incorporada suplemento para caixas de correio no local
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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Script
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.