Compartir a través de

Get-EXOMailboxFolderPermission

Módulo:
Exchange PowerShell

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.

Sintaxis

Default (valor predeterminado) 

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 de correo.

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

Aplicable: Exchange Online

El parámetro ExternalDirectoryObjectId identifica el buzón que desea ver por objectId en Microsoft Entra ID.

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

Propiedades de parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-GroupMailbox

Aplicable: Exchange Online

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Online

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.

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PrimarySmtpAddress

Aplicable: Exchange Online

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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-User

Aplicable: Exchange Online

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 devuelve un error.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserPrincipalName

Aplicable: Exchange Online

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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.