New-WebServicesVirtualDirectory
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-08-20
El cmdlet New-WebServicesVirtualDirectory permite crear un nuevo directorio virtual denominado EWS en un equipo que está ejecutando Microsoft Exchange Server 2007 y que tiene instalada la función del servidor Acceso de cliente.
Sintaxis
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Descripción detallada
El cmdlet New-WebServicesVirtualDirectory permite crear un nuevo directorio virtual denominado EWS en el servidor Acceso de cliente de Exchange 2007. Puede crear múltiples directorios virtuales mediante el uso de este cmdlet.
Nota
Sólo se puede crear un directorio virtual EWS para cada sitio web.
Para ejecutar el cmdlet New-WebServicesVirtualDirectory, la cuenta que utilice debe tener delegada la función Administrador de Exchange Server y la pertenencia al grupo Administradores local 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 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 se puede utilizar con el directorio virtual. |
BasicAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si la autenticación básica está habilitada en el directorio virtual EWS. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que el usuario confirme qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
DigestAuthentication |
Opcional |
System.Boolean |
Este parámetro, cuando se utiliza, especifica el uso de la Autenticación de acceso implícita al 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 el servicio de directorio de Active Directory, incluya el parámetro DomainController en el cmdlet. |
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. |
InternalNLBBypassUrl |
Opcional |
System.Uri |
Este parámetro especifica la dirección URL del servidor Acceso de cliente, con independencia de si está detrás de una matriz de equilibrio de carga en la red (NLB). Si bien el parámetro InternalUrl se configurará como la dirección URL de NLB, el parámetro InternalNLBBypassUrl siempre debe configurarse como la dirección URL del servidor Acceso de cliente. Esto se debe a que determinadas llamadas a servicios Web Exchange requieren afinidad de equipos y los servicios web de Exchange desviarán las llamadas entrantes a un servidor Acceso de cliente más apropiado siempre que sea posible. |
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 la ruta de acceso del directorio virtual en la metabase. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Cuando un objeto existente se suministra a este parámetro, el comando utiliza la configuración del objeto para crear una copia del objeto en un servidor local o de destino. |
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 debe usarse a la hora de crear un nuevo directorio virtual en el sitio web predeterminado. |
WindowsAuthentication |
Opcional |
System.Boolean |
Use este parámetro para especificar si la autenticación integrada de Windows se permite en el nuevo directorio virtual de servicios Web Exchange. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
Este ejemplo de código crea un nuevo directorio virtual llamado "contoso" con la URL externa configurada como "https://www.contoso.com/webservices.aspx".
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"