Get-EXORecipientPermission
Este cmdlet só está disponível no módulo Exchange Online PowerShell. Para obter mais informações, veja Acerca do módulo Exchange Online PowerShell.
Utilize o cmdlet Get-EXORecipientPermission para ver informações sobre permissões SendAs que estão configuradas para utilizadores numa organização baseada na cloud.
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 é utilizado para ver/gerir informações sobre permissões SendAs que estão configuradas para utilizadores numa organização baseada na cloud. A permissão Enviar Como permite que os delegados utilizem a caixa de correio para enviar mensagens. Após esta permissão ser atribuída a um delegado, qualquer mensagem que o delegado envie a partir da caixa de correio parece ser 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. Só permite que os utilizadores abram a caixa de correio. Se esta permissão for atribuída a um grupo, uma mensagem enviada pelo delegado parece ter sido enviada pelo grupo.
Exemplos
Exemplo 1
Get-EXORecipientPermission -ResultSize 100
O exemplo acima devolve a permissão do destinatário para os primeiros 100 utilizadores da caixa de correio na ordem ordenada pelo nome.
Parâmetros
-AccessRights
Aplicável: Exchange Online
O parâmetro AccessRights filtra os resultados por permissão. O único valor válido para este 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 pretende ver pelo ObjectId no Microsoft Entra ID.
Não pode utilizar este 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 Identidade identifica o destinatário que pretende ver. O utilizador ou grupo especificado pelo parâmetro Administrador 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 que utilize os seguintes valores para identificar o destinatário:
- ID de usuário ou nome UPN
- GUID
Caso contrário, pode utilizar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Domínio\Nome de Utilizador
- Endereço de email
- LegacyExchangeDN
- SamAccountName
Não pode utilizar este parâmetro com os parâmetros ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.
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: | 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 pretende ver pelo endereço de e-mail SMTP principal (por exemplo, navin@contoso.com).
Não pode utilizar este 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 pelo utilizador 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 mensagens aos utilizadores 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 Utilizador
- Endereço de email
- Nome principal de utilizador (UPN)
Tem de utilizar este 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 pretende ver pelo UPN (por exemplo, navin@contoso.onmicrosoft.com).
Não pode utilizar este 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 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.