Get-MapiVirtualDirectory

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Get-MapiVirtualDirectory para ver los directorios virtuales de la Interfaz de programación de aplicaciones de mensajes (MAPI) que se usan en Internet Information Services (IIS) en Microsoft servidores de Exchange. Las versiones compatibles de Microsoft Outlook usan un directorio virtual MAPI para conectarse a buzones mediante el protocolo MAPIHTTP.

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-MapiVirtualDirectory
   -Server <ServerIdParameter>
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]

Get-MapiVirtualDirectory
   [[-Identity] <VirtualDirectoryIdParameter>]
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<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-MapiVirtualDirectory -Server ContosoMail

En este ejemplo se devuelve una lista resumida de los directorios virtuales de MAPI del servidor denominado ContosoMail.

Ejemplo 2

Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" | Format-List

Get-MapiVirtualDirectory "ContosoMail\mapi (Default Web Site)" | Format-List

Get-MapiVirtualDirectory ContosoMai\mapi* | Format-List

Estos ejemplos devuelven información detallada para el directorio virtual MAPI denominado "mapi (sitio web predeterminado)" en el servidor denominado ContosoMail. Estos tres comandos hacen todos lo mismo.

Ejemplo 3

Get-MapiVirtualDirectory

En este ejemplo se muestra una lista resumida de los directorios virtuales de MAPI de los servicios de acceso de cliente en todos los servidores de buzones de correo de la organización.

Parámetros

-ADPropertiesOnly

El modificador ADPropertiesOnly especifica si se deben devolver solo las propiedades del directorio virtual almacenadas en Active Directory. No es necesario especificar un valor con este modificador.

Si no usa este modificador, se devuelven las propiedades de Active Directory y de la metabase de Internet Information Services (IIS).

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

-DomainController

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 2013, Exchange Server 2016, Exchange Server 2019

-Identity

El parámetro Identity especifica el directorio virtual de MAPI que quiere ver. You can use any value that uniquely identifies the virtual directory. Por ejemplo:

Nombre o Servidor\Nombre
Nombre completo (DN)
GUID

El valor Name usa la sintaxis "VirtualDirectoryName (WebsiteName)" de las propiedades del directorio virtual. Puede especificar el carácter comodín (*) en lugar del sitio web predeterminado mediante la sintaxis VirtualDirectoryName*.

No puede usar los parámetros Identity y Server en el mismo comando.

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

-Server

El parámetro Server especifica el servidor exchange que hospeda el directorio virtual. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

Name
FQDN
Distinguished name (DN)
ExchangeLegacyDN

No puede usar los parámetros Server y Identity en el mismo comando.

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

-ShowMailboxVirtualDirectories

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

El modificador ShowMailboxVirtualDirectories muestra información sobre los directorios virtuales back-end en los servidores de buzones de correo. No es necesario especificar un valor con este modificador.

De forma predeterminada, este cmdlet muestra información sobre los directorios virtuales en los servicios de acceso de cliente en los servidores de buzones de correo. Las conexiones de cliente se proxy desde los servicios de acceso de cliente en los servidores de buzones de correo a los servicios back-end de los servidores de buzones de correo. Los clientes no se conectan directamente a los servicios back-end.

De forma predeterminada, este cmdlet muestra información acerca de los directorios virtuales en los servicios de acceso de cliente en servidores de buzones. Las conexiones de clientes se procesan mediante proxy desde los servicios de acceso de cliente en servidores de buzones a los servicios de back-end en servidores de buzones. Los clientes no se conectan directamente a los servicios de back-end.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013

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.

Compartir a través de