New-UMVirtualDirectory
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-06-28
El cmdlet New-UMVirtualDirectory le permite crear un nuevo directorio virtual en el equipo que está ejecutando Microsoft Exchange Server 2007 con la función de servidor Acceso de cliente instalada.
Sintaxis
New-UMVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Descripción detallada
El cmdlet New-UMVirtualDirectory le permite crear un nuevo directorio virtual de mensajería unificada en el servidor de acceso de cliente de Exchange 2007. Puede crear directorios virtuales de mensajería unificada sencillos o múltiples.
Para ejecutar el cmdlet New-UMVirtualDirectory, debe usar una cuenta en la que se delegue la función Administrador de servidor Exchange 2007 y pertenecer al grupo local de administradores del 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 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
ApplicationRoot |
Opcional |
System.String |
Este parámetro especifica la ruta del sitio web definida en la metabase de Internet Information Service (ISS). De forma predeterminada, la ruta de acceso tiene el valor /W3SVC/1/ROOT, donde 1= el sitio web predeterminado. |
AppPoolId |
Opcional |
System.String |
Este parámetro especifica el nombre del grupo de aplicaciones ISS. Esta opción puede configurarse en <SERVERNAME>\Grupos de aplicaciones en el sitio web del Administrador de IIS. De forma predeterminada, el nombre del grupo está establecido en MSExchangeUMAppPool. |
BasicAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si se desea habilitar Autenticación básica en el directorio virtual. |
DigestAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si se desea habilitar Autenticación implícita en el directorio virtual. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro 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 |
Este parámetro especifica 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. |
ExternalUrl |
Opcional |
System.Uri |
Este parámetro especifica el nombre de host que se usará para conectarse al servidor de Exchange desde fuera de la red perimetral. |
InternalUrl |
Opcional |
System.Uri |
Este parámetro especifica el nombre de host del servidor de Exchange para la conexión desde dentro de la red perimetral. |
Path |
Opcional |
System.String |
Este parámetro especifica la ruta local en el servidor de acceso de cliente donde están ubicados los archivos UMWebservice. La ubicación predeterminada es %ExchangeInstallDir%\UnifiedMessaging\WebService. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Este parámetro especifica que el cmdlet usará la configuración de un objeto existente, cuando este objeto se suministra a este parámetro, para crear una copia idéntica del objeto en un servidor de destino o local. |
WebSiteName |
Opcional |
System.String |
Este parámetro especifica el nombre del sitio web en el que se creará el nuevo directorio virtual. Este parámetro no deberá usarse al crear un nuevo directorio virtual en el sitio web predeterminado. |
WindowsAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si se desea habilitar Autenticación de Windows integrada en el 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 $true. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
En este ejemplo de código se crea un nuevo directorio virtual de Mensajería unificada llamado MyUMWeb.
New-UMVirtualDirectory -MyUMWeb -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/UMwebservices.aspx"