Set-WebServicesVirtualDirectory (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-11
El cmdlet Set-WebServicesVirtualDirectory permite modificar un directorio virtual existente de servicios Web Exchange en un equipo de Exchange 2007 que tenga instalada la función del servidor Acceso de cliente.
Sintaxis
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-WindowsAuthentication <$true | $false>]
Descripción detallada
El cmdlet Set-WebServicesVirtualDirectory permite modificar un directorio virtual existente de servicios Web Exchange en un servidor Acceso de cliente de Exchange 2007.
Nota
Si tiene un conjunto de carga equilibrada de servidores Acceso de cliente, no tiene que especificar el nombre de cada servidor cuando ejecute el cmdlet. Basta con utilizar el nombre de uno de los servidores de los servidores de carga equilibrada en red.
Para ejecutar el cmdlet Set-WebServicesVirtualDirectory, debe utilizar una cuenta en la que se delegue lo siguiente:
- Función de administrador de servidores de Exchange y grupo Administradores local para el servidor de destino
Para obtener más información sobre los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Este parámetro especifica el nombre del directorio virtual. Además, puede especificar un carácter comodín en lugar del sitio web predeterminado. |
BasicAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si la autenticación básica está habilitada en el directorio virtual Servicios Web de Exchange. Este parámetro se puede utilizar con FormsAuthentication o con DigestAuthentication y WindowsAuthentication. |
DigestAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si la autenticación de acceso implícita está habilitada en el directorio virtual. |
DomainController |
Opcional |
System.String |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos del servicio de directorio Active Directory, incluya el parámetro DomainController en el cmdlet. |
ExternalUrl |
Opcional |
System.Uri |
Este parámetro especifica el nombre de host que se utilizará para conectarse al servidor de Exchange desde fuera del firewall. Además, esta configuración es importante si se usa el Nivel de sockets seguros (SSL). |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
El parámetro Instance permite pasar todo un objeto al cmdlet para su procesamiento. |
InternalUrl |
Opcional |
System.Uri |
Este parámetro especifica el nombre de host del servidor de Exchange para la conexión desde dentro del firewall. Además, esta configuración es importante si se usa SSL. |
WindowsAuthentication |
Opcional |
System.Boolean |
Este parámetro especifica si la autenticación integrada de Windows está habilitada en el directorio virtual Servicios Web de Exchange. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
El siguiente código de ejemplo define el método de autenticación como autenticación de acceso básica para el directorio virtual llamado "EWS" en el servidor llamado "Contoso". Este ejemplo de código establece además las URL externas e internas para este directorio virtual.
El segundo ejemplo de código usa un carácter comodín en lugar del "sitio web predeterminado".
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx