Get-RecipientPermission
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Get-RecipientPermission para exibir informações sobre permissões SendAs configuradas para usuários em uma organização baseada em nuvem.
Observação: no Exchange Online PowerShell, recomendamos que você use o cmdlet Get-EXORecipientPermission em vez deste cmdlet. Para saber mais, confira Conectar-se ao Exchange Online usando o PowerShell Remoto.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-RecipientPermission
[[-Identity] <RecipientIdParameter>]
[-AccessRights <MultiValuedProperty>]
[-IncludeTrusteeWithPrimarySmtpAddress]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-Trustee <SecurityPrincipalIdParameter>]
[<CommonParameters>]
Description
Quando um usuário recebe uma permissão SendAs para outro usuário ou grupo, o usuário poderá enviar mensagens que parecem ser originadas de outro usuário ou grupo.
Observação
Esse cmdlet não retorna os resultados esperados quando o destinatário especificado pelo parâmetro Trustee tem vários SecurityPrincipalIdParameter valores (Sid). Quando você usa o parâmetro Trustee, o comando compara o Sid do Trustee especificado com o registro da lista de controle de acesso (ACL) do destinatário. Se alguns dos valores de Sid do destinatário foram alterados, há uma incompatibilidade. A solução alternativa é não usar o valor do nome UPN (nome UPN) para usar todos os Sids, incluindo o do histórico.
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-RecipientPermission -Trustee "Kim Akers"
Esse exemplo lista os destinatários para os quais o usuário Kim Akers possui permissão SendAs. Kim pode enviar mensagens que parecem vir diretamente dos destinatários.
Exemplo 2
Get-RecipientPermission "Help Desk"
Esse exemplo lista os usuários que possuem permissão SendAs na caixa de correio Help Desk. Os usuários listados podem enviar mensagens que parecem vir diretamente da caixa de correio Help Desk.
Parâmetros
-AccessRights
Aplicável: Exchange Online
O parâmetro AccessRights filtra os resultados por permissão. O único valor válido para esse parâmetro é SendAs.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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 Online
O parâmetro Identity identifica o destinatário que você deseja exibir. O usuário ou grupo especificado pelo parâmetro Trustee tem permissões Enviar como neste destinatário. É possível especificar qualquer tipo de destinatário, por exemplo:
- Caixas de correio
- Usuários de email
- Contatos externos
- Grupos de distribuição
- Grupos dinâmicos de distribuição
É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
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: | RecipientIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeTrusteeWithPrimarySmtpAddress
Aplicável: Exchange Online
{{ Fill IncludeTrusteeWithPrimarySmtpAddress Description }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-ReadFromDomainController
Aplicável: Exchange Online
O parâmetroReadFromDomainController especifica se as informações do usuário são lidas em um controlador de domínio no domínio do usuário. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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
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 |
-Trustee
Aplicável: Exchange Online
O parâmetro Trustee filtra os resultados por quem tem permissões Enviar como no destinatário especificado. Você pode especificar os seguintes tipos de usuários ou grupos (entidades de segurança) para esse parâmetro:
- Usuário da caixa de correio
- Enviar email aos usuários com uma conta Microsoft
- Grupos de segurança
É possível usar qualquer valor que identifique o usuário ou grupo com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | SecurityPrincipalIdParameter |
| 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.