Get-MailboxFolder

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-MailboxFolder para ver carpetas en su propio buzón. Los administradores no pueden usar este cmdlet para ver carpetas en otros buzones (el cmdlet solo está disponible desde el rol de usuario MyBaseOptions).

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-MailboxFolder
   [[-Identity] <MailboxFolderIdParameter>]
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-MailFolderOnly]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxFolder
   [[-Identity] <MailboxFolderIdParameter>]
   [-Recurse]
   [-DomainController <Fqdn>]
   [-MailFolderOnly]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

Este comando comprueba que el buzón especificado en el parámetro Identity es un buzón de Exchange válido antes de recuperar las carpetas solicitadas. Si no especifica el modificador MailFolderOnly, el cmdlet devuelve todas las carpetas.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-MailboxFolder -Identity :\Inbox | Format List

En este ejemplo se devuelve información detallada sobre la carpeta Bandeja de entrada en su propio buzón.

Ejemplo 2

Get-MailboxFolder

En este ejemplo se devuelve una lista de resumen de las carpetas raíz de su propio buzón.

Ejemplo 3

Get-MailboxFolder -GetChildren -MailFolderOnly

En este ejemplo se devuelve el primer nivel de carpetas de correo de su propio buzón.

Ejemplo 4

Get-MailboxFolder -Identity :\Inbox -GetChildren

En este ejemplo se devuelve información sobre todas las subcarpetas de la Bandeja de entrada de su propio buzón.

Ejemplo 5

Get-MailboxFolder -Identity :\Inbox -Recurse

En este ejemplo se devuelve una lista de resumen de todos los niveles de carpetas en Bandeja de entrada en su propio buzón.

Parámetros

-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetChildren

El modificador GetChildren especifica si se devuelve únicamente el primer nivel de subcarpetas de la carpeta principal especificada. No es necesario especificar un valor con este modificador.

No puede usar este modificador con el modificador Recurse.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

El parámetro Identity especifica la carpeta de buzón que desea ver. La sintaxis es [MailboxID]:[\ParentFolder][\SubFolder].

Solo puede ejecutar este cmdlet en su propio buzón de correo, por lo que no es necesario (o no puede) especificar un MailboxID valor.

Para el valor de MailboxID, puede usar cualquier valor que identifique de forma única el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Si no se especifica la carpeta, el comando devuelve información sobre las carpetas de la jerarquía raíz del buzón especificado.

Los valores de ejemplo de este parámetro son john@contoso.com:, John:\Inbox.

Type:MailboxFolderIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MailFolderOnly

El modificador MailFolderOnly especifica si se devuelven únicamente las carpetas de correo del buzón especificado. 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Recurse

El modificador Recurse especifica si se devuelve la carpeta principal especificada y todas sus subcarpetas. No es necesario especificar un valor con este modificador.

No puede usar este modificador con el modificador GetChildren.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.