Get-RemoteDomain (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-06
Utilice el cmdlet Get-PublicFolder para recuperar los atributos de una carpeta pública o un conjunto de carpetas públicas.
Sintaxis
Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Descripción detallada
Para ejecutar el cmdlet Get-PublicFolder, se debe delegar a la cuenta lo siguiente:
- Función Administrador de Exchange con permisos de sólo vista
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
GetChildren |
Necesario |
System.Management.Automation.SwitchParameter |
Utilice el parámetro GetChildren para recuperar únicamente los objetos secundarios de la carpeta especificada por el parámetro Identity. El parámetro GetChildren se excluye mutuamente con el parámetro Recurse. |
Recurse |
Necesario |
System.Management.Automation.SwitchParameter |
El parámetro Recurse especifica que el comando debe proporcionar la cartera pública especificada y todos sus objetos secundarios. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos del servicio de directorio Active Directory, incluya el parámetro DomainController en el comando. |
Identity |
Opcional |
Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter |
Utilice el parámetro Identity para especificar el GUID o el nombre de carpeta pública que represente a un carpeta pública concreta. También puede incluir la ruta con el formato Carpeta pública de alto nivel\Carpeta pública. Puede omitir la identidad de la etiqueta del parámetro para que sólo se suministre el nombre de la carpeta pública o GUID. |
ResultSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
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, otorgue a este parámetro el valor Ilimitado. Este parámetro sólo puede transferirse en combinación con los parámetros Recurse o GetChildren. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
El parámetro Server especifica el servidor en el que realizar las operaciones seleccionadas. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
Ejemplo
Los siguientes ejemplos de código muestran cómo usar el comando Get-PublicFolder.
El primer ejemplo utiliza el comando Get-PublicFolder sin parámetros para proporcionar el objeto de carpeta pública raíz (IPM_SUBTREE).
El segundo 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).
El tercer ejemplo proporciona la carpeta pública con el identificador de entrada a largo plazo especificado.
El cuarto ejemplo proporciona la carpeta pública "Litigio pendiente" en \Legal\Documents\.
El quinto ejemplo proporciona la carpeta pública 'Litigio pendiente' en \Legal\Documents\ y hasta 9.999 carpetas públicas en la carpeta pública 'Litigio pendiente'.
El sexto ejemplo proporciona la carpeta pública 'Litigio pendiente' en \Legal\Documents\ y todas las carpetas públicas que hay en ella, sin limitar el número proporcionado.
Get-PublicFolder
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited