Compartilhar via


Get-EXOMailboxFolderPermission

Esse cmdlet está disponível apenas no módulo Exchange Online PowerShell. Para obter mais informações, consulte Sobre o módulo Exchange Online PowerShell.

Use o cmdlet Get-ExOMailboxFolderPermission para exibir permissões no nível da pasta em caixas de correio.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-EXOMailboxFolderPermission
   [[-Identity] <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-GroupMailbox]
   [-PrimarySmtpAddress <String>]
   [-User <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Description

Use esse cmdlet para recuperar a permissão do nível da pasta na caixa de correio.

Exemplos

Exemplo 1

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports

Este exemplo retorna a lista atual de permissões de usuário para a subpasta Relatórios na pasta de Marketing na caixa de correio de John.

Exemplo 2

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports -User Kim@contoso.com

Este exemplo retorna as permissões para a mesma pasta na caixa de correio de John, mas apenas para o usuário Kim.

Parâmetros

-ExternalDirectoryObjectId

O parâmetro ExternalDirectoryObjectId identifica a caixa de correio que você deseja exibir pelo ObjectId no Azure Active Directory.

Você não pode usar esse parâmetro com os parâmetros Identity, PrimarySmtpAddress ou UserPrincipalName.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-GroupMailbox

A opção GroupMailbox é necessária para retornar Grupos do Microsoft 365 nos resultados. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

O parâmetro Identidade especifica a pasta de caixa de correio que você deseja exibir. Esse parâmetro usa a sintaxe: <Mailbox>:\<Folder>. Para obter o melhor desempenho, recomendamos usar a ID do usuário ou o nome da entidade de usuário (UPN) para identificar a caixa de correio.

Caso contrário, você pode usar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • LegacyExchangeDN
  • SamAccountName

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-PrimarySmtpAddress

O PrimarySmtpAddress identifica a caixa de correio que você deseja exibir por endereço de email SMTP primário (por exemplo, navin@contoso.com).

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou UserPrincipalName.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-User

O parâmetro Usuário filtra os resultados pela caixa de correio, usuário de email ou grupo de segurança habilitado para email (entidade de segurança) que recebeu permissão para a pasta caixa de correio. É possível usar qualquer valor que identifique o usuário ou grupo com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Observação: se você especificar um usuário que não tem permissão para acessar a pasta de caixa de correio, o comando gerará uma exceção.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

O parâmetro UserPrincipalName identifica a caixa de correio que você deseja exibir por UPN (por exemplo, navin@contoso.onmicrosoft.com).

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online