Get-EXOMailboxFolderPermission

Este cmdlet solo está disponible en el módulo de PowerShell Exchange Online. Para obtener más información, vea Acerca de la Exchange Online módulo de PowerShell.

Use el cmdlet Get-ExOMailboxFolderPermission para ver los permisos de nivel de carpeta en los buzones de correo.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Use este cmdlet para recuperar el permiso de nivel de carpeta en el buzón.

Ejemplos

Ejemplo 1

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

En este ejemplo se devuelve la lista actual de permisos de usuario para la subcarpeta Reports que hay en la carpeta Marketing del buzón de John.

Ejemplo 2

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

En este ejemplo se devuelven los permisos para la misma carpeta en el buzón de John, pero solo para el usuario Kim.

Parámetros

-ExternalDirectoryObjectId

El parámetro ExternalDirectoryObjectId identifica el buzón que desea ver mediante ObjectId en Azure Active Directory.

No puede usar este parámetro con los parámetros Identity, PrimarySmtpAddress o UserPrincipalName.

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

-GroupMailbox

El modificador GroupMailbox es necesario para devolver Grupos de Microsoft 365 en los resultados. No es necesario especificar un valor con este modificador.

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

-Identity

El parámetro Identity especifica la carpeta de buzón que desea ver. Este parámetro usa la sintaxis : <Mailbox>:\<Folder>. Para obtener el mejor rendimiento, se recomienda usar el identificador de usuario o el nombre principal de usuario (UPN) para identificar el buzón.

De lo contrario, puede usar cualquier valor que identifique de forma única el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • LegacyExchangeDN
  • SamAccountName

No se puede usar este parámetro con los parámetros ExternalDirectoryObjectId, PrimarySmtpAddress o UserPrincipalName.

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

-PrimarySmtpAddress

PrimarySmtpAddress identifica el buzón que desea ver por dirección de correo electrónico SMTP principal (por ejemplo, navin@contoso.com).

No se puede usar este parámetro con los parámetros ExternalDirectoryObjectId, Identity o UserPrincipalName.

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

-User

El parámetro User filtra los resultados por el buzón de correo, el usuario de correo o el grupo de seguridad habilitado para correo (entidad de seguridad) especificado que tiene permiso para la carpeta de buzón. Puede usar cualquier valor que identifique de forma exclusiva al usuario o al grupo. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID

Nota: Si especifica un usuario que no tiene permiso para acceder a la carpeta de buzón, el comando producirá una excepción.

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

-UserPrincipalName

El parámetro UserPrincipalName identifica el buzón que quiere ver por UPN (por ejemplo, navin@contoso.onmicrosoft.com).

No se puede usar este parámetro con los parámetros ExternalDirectoryObjectId, Identity o PrimarySmtpAddress.

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