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-PublicFolderEste 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 NameEste 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" -RecurseEste 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 UnlimitedEn 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" -ResidentFoldersEn 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.