Get-EXOMailboxFolderPermission

Módulo:
Exchange PowerShell

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

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

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.

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 de la misma carpeta del 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 el 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 los 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 del 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 al buzón. Por ejemplo:

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

No 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 para el parámetro Identidad sean precisas y no contengan 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 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 especificado, el usuario de correo o el grupo de seguridad habilitado para correo (entidad de seguridad) al que se ha concedido permiso para la carpeta mailbox. 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 del 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 desea ver por UPN (por ejemplo, navin@contoso.onmicrosoft.com).

No 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.