Get-ManagementRoleEntry
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.
Utilize o cmdlet Get-ManagementRoleEntry para obter entradas de função de gestão que foram configuradas em funções de gestão.
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 obtém entradas de função que foram configuradas em funções. Pode obter entradas de função específicas que correspondam a critérios específicos, como o nome da função, o nome do cmdlet, o nome do parâmetro ou uma combinação de cada, ou o tipo de entrada de função ou o snap-in Windows PowerShell associado.
Para obter mais informações sobre entradas de 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-ManagementRoleEntry "Transport Rules\*"
Este exemplo obtém uma lista de todas as entradas de função existentes na função de gestão regras de transporte.
Exemplo 2
Get-ManagementRoleEntry *\Get-Recipient
Este exemplo obtém 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 obtém a entrada da função Suporte Técnico da Camada 2\Set-Mailbox e encaminha a saída do cmdlet Get-ManagementRoleEntry para o cmdlet Format-List. Em seguida, o cmdlet Format-List produz apenas as propriedades Nome, Parâmetros, Função e Tipo da entrada de 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, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Identidade especifica a entrada de função que pretende ver. Este parâmetro utiliza a sintaxe: <management role>\<role entry name> (por exemplo, CustomRole\Set-Mailbox).
Para obter mais informações sobre como funcionam as entradas de funções de gestão, veja Compreender as funções de gestão.
Pode utilizar o caráter universal (*) em vez da função, nome do cmdlet ou ambos.
Se o nome da entrada de função contiver espaços, coloque o nome entre aspas (").
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: | 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, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Parameters inclui apenas as entradas de função que contêm os parâmetros especificados. Pode especificar vários parâmetros, separados por vírgulas. Pode utilizar o caráter universal (*) com nomes parciais de parâmetros para obter todos os parâmetros que correspondem ao valor especificado.
Este parâmetro é útil quando utiliza o caráter universal (*) com o valor que especificar no parâmetro Identidade.
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, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro PSSnapinName especifica o Windows PowerShell snap-in que contém a entrada de função a devolver. Utilize o cmdlet Get-PSSnapin para obter 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, Suplemento de segurança incorporado para caixas de correio no local
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, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Type especifica o tipo de entrada de função a devolver. Os valores válidos para o parâmetro Tipo 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 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.