New-ActiveSyncVirtualDirectory
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2009-05-14
El comando New-ActiveSyncVirtualDirectory le permite crear nuevos directorios virtuales de Microsoft Exchange ActiveSync en sus sitios web especificados.
Sintaxis
New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El comando New-ActiveSyncVirtualDirectory hace que se cree un nuevo directorio virtual de Exchange ActiveSync en el servidor especificado del sitio web especificado. El directorio virtual de Exchange ActiveSync que se ha creado se llamará "Microsoft-ActiveSync-Server". Sólo puede existir un directorio virtual de Exchange ActiveSync en cada sitio web de Exchange ActiveSync.
Para ejecutar el cmdlet New-ActiveSyncVirtualDirectory, se debe delegar la función Administrador de Exchange y el grupo Administradores local en la cuenta para el servidor de destino.
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 |
|---|---|---|---|
ApplicationRoot |
Opcional |
System.String |
Este parámetro establece la ruta de la metabase del directorio virtual. De forma predeterminada, esta ruta es la misma que el sitio web en el que se ha creado el directorio virtual. |
AppPoolId |
Opcional |
System.String |
Este parámetro establece el grupo de programas que puede utilizarse con el directorio virtual. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que el administrador reconozca qué hará el comando antes de seguir con el procesamiento. El valor predeterminado es $true. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo del controlador (FQDN) de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory. |
ExternalAuthenticationMethods |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los métodos de autenticación admitidos por el servidor que contiene el directorio virtual cuando se solicita acceso desde fuera del firewall de la red. Si no está establecido este parámetro, pueden utilizarse todos los métodos de autenticación. |
ExternalUrl |
Opcional |
System.Uri |
Este parámetro especifica la URL que se utiliza para conectarse al directorio virtual desde fuera del firewall de la red. |
InstallProxySubDirectory |
Opcional |
System.Boolean |
El parámetro InstallProxySubDirectory controla cómo se crea el nuevo subdirectorio de Exchange ActiveSync que se usa como proxy entre Microsoft Exchange Server 2010 y Exchange Server 2007. |
InternalAuthenticationMethods |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los métodos de autenticación admitidos por el servidor que contiene el directorio virtual cuando se solicita acceso desde dentro del firewall de la red. Si no está establecido este parámetro, pueden utilizarse todos los métodos de autenticación. |
InternalUrl |
Opcional |
System.Uri |
Este parámetro especifica la URL que se utiliza para conectarse al directorio virtual desde dentro del firewall de la red. |
Path |
Opcional |
System.String |
Este parámetro establece el directorio que contiene los archivos de sistema del directorio virtual. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Este parámetro especifica que el cmdlet usará la configuración de un objeto existente, cuando ese objeto se suministra a este parámetro, para duplicar ese objeto en un servidor de destino o local. |
WebSiteName |
Opcional |
System.String |
Este parámetro especifica el nombre del sitio web de Exchange ActiveSync en el que se creará el nuevo directorio virtual. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, el administrador puede ver los cambios que se producirían sin tener que aplicarlos. El valor predeterminado es $false. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
Excepciones
| Excepciones | Descripción |
|---|---|
Ejemplo
El siguiente ejemplo de código crea un nuevo directorio virtual en el servidor Contoso.
New-ActiveSyncVirtualDirectory -Server "Contoso" -WebSiteName "Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"