Set-WebServicesVirtualDirectory
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2011-06-21
El cmdlet Set-WebServicesVirtualDirectory permite modificar un directorio virtual existente de servicios web de 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>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Descripción detallada
El cmdlet Set-WebServicesVirtualDirectory permite modificar un directorio virtual existente de servicios web de 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 carga equilibrada en red.
Para ejecutar el cmdlet Set-WebServicesVirtualDirectory, debe usar una cuenta que tenga delegada la función Administrador de Exchange Server y pertenezca al grupo local 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 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. También puede especificar un carácter comodín, en vez 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. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca 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 especifica si la autenticación de acceso implícita está habilitada en el directorio virtual. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos del servicio de directorioActive 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. Esta configuración también es importante cuando se utiliza 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. |
InternalNLBBypassUrl |
Opcional |
System.Uri |
Este parámetro especifica la URL del servidor de acceso de cliente incluso aunque el servidor de acceso de cliente está detrás de un equilibrador de carga de red (NLB). |
InternalUrl |
Opcional |
System.Uri |
Este parámetro especifica el nombre de host del servidor de Exchange para la conexión desde dentro del firewall. Esta configuración también es importante cuando se utiliza una conexión SSL. |
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. |
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 también define las direcciones URL externa e interna para este directorio virtual.
El segundo ejemplo de código usa un carácter comodín en lugar de "sitio web predeterminado".
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx