Get-EXORecipientPermission
Este cmdlet está disponível somente no módulo do PowerShell do Exchange Online. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.
Use o cmdlet Get-EXORecipientPermission para exibir informações sobre as permissões SendAs configuradas para usuários em uma organização baseada em nuvem.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-EXORecipientPermission
[-AccessRights <MultiValuedProperty>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[<CommonParameters>]
Identity
Get-EXORecipientPermission
[[-Identity] <String>]
[-AccessRights <MultiValuedProperty>]
[-ExternalDirectoryObjectId <Guid>]
[-PrimarySmtpAddress <String>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Description
Este cmdlet é usado para exibir/gerenciar informações sobre permissões SendAs configuradas para usuários em uma organização baseada em nuvem. A permissão Enviar como permite que os representantes usem a caixa de correio para enviar mensagens. Depois que essa permissão é atribuída a um representante, qualquer mensagem enviada pelo representante da caixa de correio parece ter sido enviada pelo proprietário da caixa de correio. Entretanto, essa permissão não permite que um representante entre na caixa de correio do usuário. Ele só permite que os usuários abram a caixa de correio. Se essa permissão for atribuída a um grupo, uma mensagem enviada pelo representante parecerá ser enviada pelo grupo.
Exemplos
Exemplo 1
Get-EXORecipientPermission -ResultSize 100
O exemplo acima retorna a permissão de destinatário para os primeiros 100 usuários da caixa de correio na ordem de classificação de nomes.
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 |
-ExternalDirectoryObjectId
Aplicável: Exchange Online
O parâmetro ExternalDirectoryObjectId identifica o destinatário que você deseja exibir pela ObjectId no Microsoft Entra ID.
Não é possível usar esse parâmetro com os parâmetros Identity, PrimarySmtpAddress ou UserPrincipalName.
Propriedades do parâmetro
| Tipo: | Guid |
| 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: | True |
| 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 e-mail
- Contatos de email
- Grupos de distribuição
- Grupos dinâmicos de distribuição
Para obter o melhor desempenho, recomendamos o uso dos seguintes valores para identificar o destinatário:
- ID de usuário ou nome UPN
- GUID
Caso contrário, você poderá usar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- LegacyExchangeDN
- SamAccountName
Não é possível usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.
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: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PrimarySmtpAddress
Aplicável: Exchange Online
O PrimarySmtpAddress identifica o destinatário que você deseja exibir pelo endereço de email SMTP primário (por exemplo, navin@contoso.com).
Não é possível usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou UserPrincipalName.
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: | True |
| 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 usuário ou grupo que tem permissões Enviar como. É possível especificar os seguintes tipos de usuários ou grupos:
- 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
- Nome UPN
Você precisa usar esse parâmetro com os parâmetros Identity, PrimarySmtpAddress, UserPrincipalName ou ExternalDirectoryObjectId.
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 |
-UserPrincipalName
Aplicável: Exchange Online
O parâmetro UserPrincipalName identifica o destinatário que você deseja exibir por UPN (por exemplo, navin@contoso.onmicrosoft.com).
Não é possível usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.
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: | True |
| 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.