New-ActiveSyncVirtualDirectory
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet New-ActiveSyncVirtualDirectory para crear Exchange ActiveSync directorios virtuales que se usan en Internet Information Services (IIS) en servidores Microsoft Exchange.
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)
New-ActiveSyncVirtualDirectory
[-ApplicationRoot <String>]
[-AppPoolId <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalAuthenticationMethods <MultiValuedProperty>]
[-ExternalUrl <Uri>]
[-InstallProxySubDirectory <Boolean>]
[-InternalAuthenticationMethods <MultiValuedProperty>]
[-InternalUrl <Uri>]
[-Path <String>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-WhatIf]
[<CommonParameters>]
Description
El cmdlet New-ActiveSyncVirtualDirectory crea un directorio virtual Exchange ActiveSync en el servidor especificado en el sitio web especificado. El directorio virtual de Exchange ActiveSync creado se denomina Microsoft-Server-ActiveSync. Sólo puede existir un directorio virtual de Exchange ActiveSync en cada sitio web de Exchange ActiveSync.
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 tiene asignados. 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
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/Microsoft-Server-ActiveSync
Este ejemplo crea un directorio virtual de Exchange ActiveSync y especifica la dirección URL externa utilizada para conectarse al directorio virtual.
Ejemplo 2
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/mail -InternalUrl https://contoso/mail
Este ejemplo crea un directorio virtual de Exchange ActiveSync y especifica las direcciones URL externas e internas que se usan para conectarse al directorio virtual.
Ejemplo 3
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl "https://www.fourthcoffee.com/Microsoft-Server-ActiveSync"
Este ejemplo crea un directorio virtual de Exchange ActiveSync para la empresa Fourth Coffee.
Parámetros
-ApplicationRoot
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ApplicationRoot especifica la ruta de acceso de metabase del directorio virtual. De forma predeterminada, esta ruta es la misma que el sitio web en el cual se creará el directorio virtual.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AppPoolId
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro AppPoolId especifica el grupo de aplicaciones de IIS donde se ejecuta el directorio virtual. Recomendamos que deje este parámetro en su configuración predeterminada.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador 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 Confirm sin un valor introduce una pausa que le obliga a reconocer 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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExtendedProtectionFlags
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ExtendedProtectionFlags especifica la configuración personalizada de la protección ampliada para la autenticación en el directorio virtual. Los valores admitidos son:
- Ninguna: es el valor predeterminado.
- AllowDotlessSPN: Necesario si desea utilizar valores de nombre de entidad de seguridad de servicio (SPN) que no contengan 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 garantizar que la conexión de cliente a proxy se estableció a través de un canal seguro.
- NoServiceNameCheck: No se comprueba la lista 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: es posible que el tráfico HTTP y HTTPS esté accediendo al directorio virtual y que haya un servidor proxy situado entre, al menos, algunos de los clientes y los servicios de Acceso de clientes del servidor 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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExtendedProtectionSPNList
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ExtendedProtectionSPNList especifica una lista de nombres de entidad de seguridad de servicio (SPN) válidos si usa la protección extendida para la autenticación en el directorio virtual. Los valores admitidos son:
- $null: Este valor es el predeterminado.
- SPN único o lista delimitada por comas de SPN válidos: el formato del valor SPN es
Protocol\FQDN. Por ejemplo, HTTP/mail.contoso.com. Para agregar un SPN que no sea 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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExtendedProtectionTokenChecking
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ExtendedProtectionTokenChecking especifica si se usa la protección extendida para la autenticación 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 los clientes al directorio virtual. Este valor es el predeterminado.
- Permitir: la protección ampliada para la autenticación se usa para las conexiones de los clientes al directorio virtual si tanto el cliente como el servidor lo admiten.
- Requerir: se requiere protección ampliada para la autenticación para las conexiones de los clientes 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 termina el canal de seguridad de la capa de transporte (TLS) de cliente a proxy, los valores Permitir o Requerir 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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExternalAuthenticationMethods
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ExternalAuthenticationMethods restringe los métodos de autenticación que se pueden utilizar para conectarse al directorio virtual desde fuera del firewall. Los valores admitidos son:
- ADFS
- Basic
- Certificado
- Digest
- Logística de Amazon
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- Negociar
- NTLM
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
Aunque puede especificar cualquiera de estos valores, que el método de autenticación funcione realmente o no para conexiones externas depende de otros factores. Por ejemplo:
- Aunque se puede especificar cualquiera de estos valores, el funcionamiento correcto del método de autenticación en las conexiones internas depende de otros factores. Por ejemplo:
- ¿El método de autenticación está disponible en el directorio virtual?
El valor predeterminado está en blanco ($null), lo que significa que se aceptan todos los métodos de autenticación disponibles.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExternalUrl
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro ExternalURL especifica la dirección URL que se conecta al directorio virtual desde fuera del firewall.
Propiedades de parámetro
| Tipo: | Uri |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InstallProxySubDirectory
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro InstallProxySubDirectory se ha usado para crear el subdirectorio necesario para conexiones proxy de ActiveSync con Exchange 2007.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InternalAuthenticationMethods
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro InternalAuthenticationMethods restringe los métodos de autenticación que se pueden utilizar para conectarse al directorio virtual desde dentro del firewall. Los valores admitidos son:
- ADFS
- Basic
- Certificado
- Digest
- Logística de Amazon
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- Negociar
- NTLM
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
Aunque puede especificar cualquiera de estos valores, el hecho de que el método de autenticación funcione realmente para las conexiones internas depende de otros factores. Por ejemplo:
- Aunque se puede especificar cualquiera de estos valores, el funcionamiento correcto del método de autenticación en las conexiones internas depende de otros factores. Por ejemplo:
- ¿El método de autenticación está disponible en el directorio virtual?
El valor predeterminado está en blanco ($null), lo que significa que se aceptan todos los métodos de autenticación disponibles.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InternalUrl
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro InternalURL especifica la dirección URL que se conecta al directorio virtual desde dentro del firewall.
Propiedades de parámetro
| Tipo: | Uri |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Path
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro Path especifica la ruta del sistema de archivos del directorio virtual. Recomendamos usar este parámetro solo cuando sea necesario usar una ubicación personalizada para los archivos del directorio virtual. El valor predeterminado está en blanco ($null), lo que indica que se usa la ubicación predeterminada.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Role
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro Role crea una especie de la configuración del directorio virtual. Los valores admitidos son:
- ClientAccess: configure el directorio virtual para los servicios de Acceso de clientes (front-end) en el servidor Buzón de correo.
- Buzón: configure el directorio virtual para los servicios back-end en el servidor Buzón de correo.
Las conexiones de cliente son proxys desde los servicios de Acceso de clientes a los servicios back-end en servidores de buzones locales o remotos. Los clientes no se conectan directamente a los servicios back-end.
Propiedades de parámetro
| Tipo: | VirtualDirectoryRole |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Server
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Propiedades de parámetro
| Tipo: | ServerIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-WebSiteName
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
El parámetro WebSiteName especifica el nombre del sitio web de IIS en el que se crea el directorio virtual. No es necesario usar este parámetro para crear el directorio virtual en el sitio web predeterminado.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
| Mandatory: | 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.