Set-MapiVirtualDirectory

Módulo:: Exchange PowerShell

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

Use el cmdlet Set-MapiVirtualDirectory para modificar los directorios virtuales de la Interfaz de programación de aplicaciones de mensajería (MAPI) que se usan en Internet Information Services (IIS) en servidores de Microsoft 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.

Sintaxis

Default (valor predeterminado)

Set-MapiVirtualDirectory
    [-Identity] <VirtualDirectoryIdParameter>
    [-ApplyDefaults <Boolean>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalUrl <Uri>]
    [-IISAuthenticationMethods <MultiValuedProperty>]
    [-InternalUrl <Uri>]
    [-WhatIf]
    [<CommonParameters>]

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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

Set-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate,OAuth

En este ejemplo se hacen los siguientes cambios de configuración en el directorio virtual de MAPI en el sitio web predeterminado del servidor ContosoMail:

Dirección URL interna: https://contoso/mapi.
Métodos de autenticación de IIS: NTLM, Negotiate y OAuth.

Parámetros

-ApplyDefaults

El modificador ApplyDefaults especifica si se deben aplicar los valores predeterminados correctos a la configuración de la aplicación IIS interna relacionada. Normalmente, este modificador solo lo usa el programa de instalación de Exchange durante la instalación de Novedades acumulativas de Exchange o Service Packs y no es necesario usarlo.

Este modificador no afecta a los valores que se configuran con los parámetros IISAuthenticationMethods, InternalUrl o ExternalUrl.

Propiedades de parámetro

Tipo:	Boolean
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. La forma en que este modificador afecta al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirmar sin un valor introduce una pausa que obliga a confirmar el comando antes de continuar.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

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

Propiedades de parámetro

Tipo:	Fqdn
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ExtendedProtectionFlags

El parámetro ExtendedProtectionFlags especifica la configuración personalizada para Extended Protection for Authentication en el directorio virtual. Los valores admitidos son:

Ninguna: es el valor predeterminado.
AllowDotlessSPN: obligatorio si desea usar valores de nombre principal de servicio (SPN) que no contienen FQDN (por ejemplo, HTTP/ContosoMail en lugar de HTTP/mail.contoso.com). Los SPN se especifican con el parámetro ExtendedProtectionSPNList. Esta configuración hace que la protección ampliada para la autenticación sea menos segura porque los certificados sin punto no son únicos, por lo que no es posible asegurarse de que la conexión de cliente a proxy se estableció a través de un canal seguro.
NoServiceNameCheck: no se comprueba la lista de SPN para validar un token de enlace de canal. Esta configuración hace que la protección ampliada para la autenticación sea menos segura. Por lo general, no se recomienda esta configuración.
Proxy: un servidor proxy es responsable de terminar el canal TLS. Para usar esta configuración, debe registrar un SPN mediante el parámetro ExtendedProtectionSPNList.
ProxyCoHosting: el tráfico HTTP y HTTPS podría tener acceso al directorio virtual y un servidor proxy se encuentra entre al menos algunos de los clientes y los servicios de acceso de cliente en el servidor de Exchange.

Propiedades de parámetro

Tipo:	MultiValuedProperty
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ExtendedProtectionSPNList

El parámetro ExtendedProtectionSPNList especifica una lista de nombres de entidad de seguridad de servicio (SPN) válidos si usa Extended Protection for Authentication en el directorio virtual. Los valores admitidos son:

$null: este valor es el predeterminado.
Una sola SPN o lista delimitada por comas de SPN válidos: el formato de valor de SPN es Protocol\FQDN. Por ejemplo, HTTP/mail.contoso.com. Para agregar un SPN que no sea un FQDN (por ejemplo, HTTP/ContosoMail), también debe usar el valor AllowDotlessSPN para el parámetro ExtendedProtectionFlags.

Propiedades de parámetro

Tipo:	MultiValuedProperty
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ExtendedProtectionTokenChecking

El parámetro ExtendedProtectionTokenChecking especifica si se usa Extended Protection for Authentication para las conexiones de cliente al directorio virtual. Los valores admitidos son:

Ninguno: la protección ampliada para la autenticación no se usa para las conexiones de cliente al directorio virtual. Este valor es el predeterminado.
Permitir: la protección ampliada para la autenticación se usa para las conexiones de cliente al directorio virtual si el cliente y el servidor lo admiten.
Requerir: se requiere protección ampliada para la autenticación para las conexiones de cliente al directorio virtual. Si el cliente o el servidor no lo admiten, se produce un error en la conexión. Este valor también requiere un valor de Nombre de entidad de seguridad de servicio (SPN) para el parámetro ExtendedProtectionSPNList.

Nota: Si un servidor proxy delante del servidor exchange finaliza el canal de seguridad de la capa de transporte de cliente a proxy (TLS), los valores Allow o Require necesitan uno o varios valores SPN para el parámetro ExtendedProtectionSPNList.

Propiedades de parámetro

Tipo:	ExtendedProtectionTokenCheckingMode
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ExternalUrl

El parámetro ExternalURL especifica la dirección URL que se conecta al directorio virtual desde fuera del firewall.

Esta configuración aplica el protocolo seguridad de la capa de transporte (TLS) y usa el puerto TLS predeterminado. La entrada válida para este parámetro usa la sintaxis https://<Domain Name>/mapi(por ejemplo, https://external.contoso.com/mapi).

Cuando se usan los parámetros InternalUrl o ExternalUrl, es necesario especificar uno o varios valores de autenticación mediante el parámetro IISAuthenticationMethods.

Propiedades de parámetro

Tipo:	Uri
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Identity

El parámetro Identity especifica el directorio virtual MAPI que desea modificar. 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*.

Propiedades de parámetro

Tipo:	VirtualDirectoryIdParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	1
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-IISAuthenticationMethods

El parámetro IISAuthenticationMethods especifica los métodos de autenticación que se habilitan en el directorio virtual de Internet Information Services (IIS). Los valores admitidos son:

Basic
Negociar
NTLM
OAuth

Puede especificar distintos valores separados por comas.

Los valores predeterminados son NTLM, OAuth y Negotiate. Se recomienda tener siempre el directorio virtual configurado para OAuth.

Para obtener más información sobre los distintos métodos de autenticación, consulte Descripción de la autenticación HTTP y ¿Qué es la autenticación de OAuth?.

Propiedades de parámetro

Tipo:	MultiValuedProperty
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InternalUrl

El parámetro InternalURL especifica la dirección URL que se conecta al directorio virtual desde dentro del firewall.

Esta configuración aplica el protocolo seguridad de la capa de transporte (TLS) y usa el puerto TLS predeterminado. La entrada válida para este parámetro usa la sintaxis https://<Domain Name>/mapi (por ejemplo, https://internal.contoso.com/mapi).

Cuando se usan los parámetros InternalUrl o ExternalUrl, es necesario especificar uno o varios valores de autenticación mediante el parámetro IISAuthenticationMethods.

Propiedades de parámetro

Tipo:	Uri
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

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.

Comentarios

¿Le ha resultado útil esta página?