Get-ManagementRoleEntry
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 ambiente ou de outro.
Use o cmdlet Get-ManagementRoleEntry para recuperar entradas de função de gerenciamento que foram configuradas em funções de gerenciamento.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-ManagementRoleEntry
[-Identity] <RoleEntryIdParameter>
[-DomainController <Fqdn>]
[-Parameters <String[]>]
[-PSSnapinName <String>]
[-ResultSize <Unlimited>]
[-Type <ManagementRoleEntryType[]>]
[<CommonParameters>]
Description
O cmdlet Get-ManagementRoleEntry recupera entradas de função que foram configuradas em funções. Você pode recuperar entradas de função específicas que correspondam a critérios específicos, como nome da função, nome do cmdlet, nome do parâmetro ou uma combinação de ambos, ou o tipo de entrada de função ou o snap-in do Windows PowerShell associado.
Para obter mais informações sobre entradas de função de gerenciamento, consulte Noções básicas sobre funções de gerenciamento.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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-ManagementRoleEntry "Transport Rules\*"
Este exemplo recupera uma lista de todas as entradas de função que existem na função de gerenciamento Regras de Transporte.
Exemplo 2
Get-ManagementRoleEntry *\Get-Recipient
Este exemplo recupera uma lista de todas as entradas de função que contêm o cmdlet Get-Recipient.
Exemplo 3
Get-ManagementRoleEntry "Tier 2 Help Desk\Set-Mailbox" | Format-List Name, Parameters, Role, Type
Este exemplo recupera a entrada da função Suporte Técnico\Set-Mailbox da Camada 2 e canaliza a saída do cmdlet Get-ManagementRoleEntry para o cmdlet Format-List. Em seguida, o cmdlet Format-List gera apenas as propriedades Name, Parameters, Role e Type da entrada da função.
Parâmetros
-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 |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
O parâmetro Identity especifica a entrada de função que você deseja exibir. Esse parâmetro usa a sintaxe: <management role>\<role entry name> (por exemplo, CustomRole\Set-Mailbox).
Para obter mais informações sobre como funcionam as entradas de função de gerenciamento, consulte Noções básicas sobre funções de gerenciamento.
Você pode usar o caractere curinga (*) em vez da função, nome do cmdlet ou ambos.
Se o nome da entrada da função contiver espaços, coloque o nome entre aspas (").
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | RoleEntryIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Parameters
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
O parâmetro Parameters inclui apenas as entradas de função que contêm os parâmetros especificados. Você pode especificar vários parâmetros, separados por vírgulas. Você pode usar o caractere curinga (*) com nomes de parâmetros parciais para recuperar todos os parâmetros que correspondam ao valor especificado.
Esse parâmetro é útil quando você usa o caractere curinga (*) com o valor especificado no parâmetro Identity.
Propriedades do parâmetro
| Tipo: | String[] |
| 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 |
-PSSnapinName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
O parâmetro PSSnapinName especifica o snap-in do Windows PowerShell que contém a entrada de função a ser retornada. Use o cmdlet Get-PSSnapin para recuperar uma lista de snap-ins Windows PowerShell disponíveis.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-ResultSize
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
Propriedades do parâmetro
| Tipo: | Unlimited |
| 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 |
-Type
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
O parâmetro Type especifica o tipo de entrada de função a ser retornada. Os valores válidos para o parâmetro Type são qualquer combinação dos seguintes parâmetros, separados por vírgulas: Cmdlet, Script e ApplicationPermission.
Propriedades do parâmetro
| Tipo: | ManagementRoleEntryType[] |
| 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 |
CommonParameters
Este cmdlet dá suporte aos 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.