Compartilhar via

Get-EXOMailboxFolderPermission

Módulo:
Exchange PowerShell

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-ExOMailboxFolderPermission para ver permissões ao 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.

Sintaxe

Default (Default) 

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

Description

Utilize este cmdlet para obter a permissão ao 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 devolve as permissões para a mesma pasta na caixa de correio do João, mas apenas para o utilizador Kim.

Parâmetros

-ExternalDirectoryObjectId

Aplicável: Exchange Online

O parâmetro ExternalDirectoryObjectId identifica a caixa de correio 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

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-GroupMailbox

Aplicável: Exchange Online

O comutador GroupMailbox é necessário para devolver Grupos do Microsoft 365 nos resultados. 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

-Identity

Aplicável: Exchange Online

O parâmetro Identidade especifica a pasta da caixa de correio que pretende ver. Esse parâmetro usa a sintaxe: <Mailbox>:\<Folder>. Para obter o melhor desempenho, recomendamos que utilize o ID de utilizador ou o nome principal de utilizador (UPN) para identificar a caixa de correio.

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

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • 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

(All)
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 a caixa de correio 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

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-User

Aplicável: Exchange Online

O parâmetro Utilizador filtra os resultados pela caixa de correio especificada, utilizador de correio ou grupo de segurança com capacidade de correio (principal de segurança) ao qual é concedida permissão para a pasta da 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

Nota: se especificar um utilizador que não tem permissão para aceder à pasta da caixa de correio, o comando devolve um erro.

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 a caixa de correio 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

(All)
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.