Compartir a través de


Get-PublicFolder

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.

Utilice el cmdlet Get-PublicFolder para recuperar los atributos de una carpeta pública o un conjunto de carpetas públicas.

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-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]
Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-Recurse]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]
Get-PublicFolder
   [-LostAndFound]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Description

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-PublicFolder

Este ejemplo usa el comando Get-PublicFolder sin parámetros para proporcionar el objeto de carpeta pública raíz (IPM_SUBTREE).

Ejemplo 2

Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name

Este ejemplo proporciona los nombres de todas las carpetas del sistema (que no se muestran de forma predeterminada), que comienzan en la carpeta raíz del sistema (\NON_IPM_SUBTREE).

Ejemplo 3

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"

Este ejemplo proporciona la carpeta pública "Litigio pendiente" en \Legal\Documents\.

Ejemplo 4

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse

Este ejemplo proporciona la carpeta pública 'Litigio pendiente' en \Legal\Documents\ y todas las carpetas públicas en la carpeta pública 'Litigio pendiente'. Debido a que no se especifica el límite del resultado, el comando devuelve hasta 10.000 carpetas públicas, el número máximo permitido.

Ejemplo 5

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited

En este ejemplo se proporciona la carpeta pública 'Litigio pendiente' en \Legal\Documents\ y todas las carpetas públicas en la carpeta pública 'Litigio pendiente', sin limitar el número proporcionado.

Ejemplo 6

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

En este ejemplo se devuelven las carpetas públicas que residen en el buzón de contenido de carpetas públicas "Legal Department".

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 deben devolver solo los elementos secundarios de la carpeta especificada por el parámetro Identity. No es necesario especificar un valor con este modificador.

No puede usar este modificador con los modificadores Recurse o LostAndFound.

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 el nombre y la ruta de acceso de la carpeta pública que desea ver. Un valor válido usa la sintaxis : \Level1\Level2\...\LevenN\PublicFolder. Por ejemplo, "\Customer Discussion" o "\Engineering\Customer Discussion".

Type:PublicFolderIdParameter
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

-LostAndFound

El modificador LostAndFound especifica si se deben devolver solo las carpetas huérfanas que se encuentran en \NON_IPM_SUBTREE\LOST_AND_FOUND. No es necesario especificar un valor con este modificador.

La carpeta LOST_AND_FOUND contiene carpetas que faltan que se vuelven a crear mediante el proceso de conciliación de la jerarquía de carpetas públicas cuando la carpeta existe en un buzón de carpeta pública secundario, pero no en el principal.

No se puede usar este modificador con el parámetro Identity o los modificadores Recurse o LostAndFound.

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

-Mailbox

El parámetro Mailbox especifica la identidad del buzón de carpeta pública de jerarquía. Es posible usar cualquier valor que identifique exclusivamente 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)
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Organization

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

Este parámetro está reservado para uso interno de Microsoft.

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

-Recurse

El modificador Recurse especifica si se debe devolver la carpeta pública especificada y todos sus elementos secundarios. No es necesario especificar un valor con este modificador.

No se puede usar este modificador con los modificadores GetChildren o LostAndFound.

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

-ResidentFolders

El modificador ResidentFolders especifica si se deben devolver carpetas públicas que residen en un buzón de carpeta pública de contenido específico. No es necesario especificar un valor con este modificador.

Si no usa este modificador, el comando devolverá solo carpetas públicas cuyo contenido resida en el buzón de carpeta pública de la jerarquía principal.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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. El máximo predeterminado es 10.000. Para que no haya ningún límite en los resultados proporcionados, configure este parámetro en Unlimited. Este parámetro sólo puede transferirse en combinación con los parámetros Recurse o GetChildren.

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

-Server

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Server filtra los resultados por el servidor de Exchange especificado. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

  • Name
  • FQDN
  • Distinguished name (DN)
  • Nombre distintivo (DN) heredado de Exchange
Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

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.