New-ActiveSyncVirtualDirectory (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-11
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>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-Server <ServerIdParameter>] [-TemplateInstance <PSObject>] [-WebSiteName <String>]
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, la cuenta que use deberá tener delegadas las funciones siguientes:
- Función de administrador de servidores de Exchange y grupo Administradores local 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. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en Active Directory, incluya el parámetro DomainController en el comando. |
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 el localizador de recursos universal (URL) que se utiliza para conectarse al directorio virtual desde fuera del firewall de la red. |
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. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Este parámetro define el servidor en el que se creará el nuevo directorio virtual de Exchange ActiveSync. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Cuando se suministra un objeto existente a este parámetro, el comando utilizará la configuración de dicho objeto para crear un duplicado exacto del mismo en un servidor local o de destino. |
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. |
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 "Contoso/Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"