Configuración de redirección <configurationRedirection>

2024-03-19

Información general

El elemento <configurationRedirection> le permite compartir archivos de configuración desde una ubicación centralizada a varios equipos de servidor de Internet Information Services (IIS) 7 en una granja de servidores web. Esto le permite configurar un servidor IIS 7 en la granja de servidores web y compartir los valores de configuración resultantes en todos los servidores IIS 7 de la granja de servidores web. Este elemento también le permite almacenar las opciones de configuración en un servidor UNC al que pueden acceder todos los equipos de servidor web de la granja de servidores web.

Cambios en IIS 7.5

En IIS 7.5, se han agregado dos atributos nuevos que controlan si IIS usará notificaciones de cambio o sondeo UNC para determinar si los archivos de configuración han cambiado. Estos atributos son los siguientes:

enableUncPolling:
- Cuando se establece en true, IIS comprobará periódicamente el recurso compartido UNC para probar si se han actualizado los archivos de configuración.
- Cuando se establece en false, las notificaciones de cambio se seguirán usando tal como estaban en IIS 7.0.
pollingPeriod: especifica el intervalo de tiempo entre comprobaciones UNC que IIS usará.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento `<configurationRedirection>` no se modificó en IIS 10.0.
IIS 8.5	El elemento `<configurationRedirection>` no se modificó en IIS 8.5.
IIS 8.0	El elemento `<configurationRedirection>` no se modificó en IIS 8.0.
IIS 7.5	Los atributos `enableUncPolling` y `pollingPeriod` se agregaron en IIS 7.5.
IIS 7.0	El elemento `<configurationRedirection>` se introdujo en IIS 7.0.
IIS 6,0	IIS 6.0 no admitía la configuración compartida.

Configuración

El elemento <configurationRedirection> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

Cómo exportar las opciones de configuración y habilitar la configuración compartida

Abra el Administrador de Internet Information Services (IIS):
- Si usa Windows Server 2012 o Windows Server 2012 R2:
  - En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).
- Si usa Windows 8 o Windows 8.1:
  - Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
  - En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
- Si usa Windows Server 2008 o Windows Server 2008 R2:
  - En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).
- Si usa Windows Vista o Windows 7:
  - En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
  - Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
En el panel Conexiones, haga clic en la conexión de servidor para la que desea configurar el redireccionamiento de configuración.
En el panel Inicio, haga doble clic en Configuración compartida.
En el panel Acciones, haga clic en Exportar configuración
En el cuadro de diálogo Exportar configuración, escriba la ruta de acceso al directorio donde desea exportar los archivos de configuración en el cuadro Ruta de acceso física, escriba y confirme la contraseña de cifrado y, a continuación, haga clic en Aceptar.
Cuando aparezca el cuadro de diálogo Exportar configuración, haga clic en Aceptar.

Habilitación de la configuración compartida

Abra el Administrador de Internet Information Services (IIS):
- Si usa Windows Server 2012 o Windows Server 2012 R2:
  - En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).
- Si usa Windows 8 o Windows 8.1:
  - Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
  - En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
- Si usa Windows Server 2008 o Windows Server 2008 R2:
  - En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).
- Si usa Windows Vista o Windows 7:
  - En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
  - Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
En el panel Conexiones, haga clic en la conexión de servidor para la que desea configurar el redireccionamiento de configuración.
En el panel Inicio, haga doble clic en Configuración compartida.
En el panel Configuración compartida, seleccione la opción Habilitar configuración compartida.
En el cuadro Ruta de acceso física, escriba la ruta de acceso a los archivos de configuración compartidos, escriba el nombre de cuenta con permisos para acceder a los archivos de configuración compartidos en el cuadro Nombre de usuario, escriba la contraseña de la cuenta en el cuadro Contraseña y, a continuación, escriba la contraseña de la cuenta de nuevo en el cuadro Confirmar contraseña.
En el panel Acciones, haga clic en Aplicar.
En el cuadro de contraseña Escribir de clave de cifrado del cuadro de diálogo Contraseña de claves de cifrado, escriba la contraseña para la clave de cifrado que creó en el paso 5 y, a continuación, haga clic en Aceptar.
En cada uno de los cuadros de diálogo Configuración compartida que aparecen, haga clic en Aceptar para cerrar los diálogos.

Nota:

Debe cerrar y reiniciar el Administrador de IIS antes de reflejar estos cambios de configuración.

Configuración

El elemento <configurationRedirection> está configurado en el archivo Redirection.config.

Atributos

Atributo	Descripción
`enabled`	Atributo Boolean opcional. Especifica si el redireccionamiento de configuración está habilitado o deshabilitado en el servidor web. El valor predeterminado es `false`.
`enableUncPolling`	Atributo Boolean opcional. true si se debe usar el sondeo UNC para comprobar si se han actualizado los archivos de configuración; de lo contrario, false si se deben usar las notificaciones de cambio. Nota: El atributo `pollingPeriod` configura el intervalo de tiempo entre comprobaciones. Nota: Este atributo se ha agregado en IIS 7.5. El valor predeterminado es `false`.
`password`	Atributo de cadena opcional. Especifica la contraseña que necesita para autenticar el nombre de usuario para acceder a la ubicación del almacenamiento de archivos de configuración. Se trata de una cadena que distingue mayúsculas de minúsculas. Nota: Para evitar almacenar cadenas de contraseña sin cifrar en archivos de configuración, use siempre AppCmd.exe o el Administrador de IIS para escribir contraseñas. Si usa estas herramientas de administración, las cadenas de contraseña se cifrarán automáticamente antes de que se escriban en los archivos de configuración XML. Esto proporciona una mejor seguridad de contraseña que almacenar contraseñas sin cifrar.
`path`	Atributo de cadena opcional. Especifica la ubicación desde la que se van a leer los archivos de configuración y las claves de cifrado. Puede ser una ruta de acceso de red o una carpeta en el equipo local. No existe ningún valor predeterminado.
`pollingPeriod`	Atributo timeSpan opcional. Especifica el intervalo de tiempo entre comprobaciones que IIS usará para comprobar si se han actualizado los archivos de configuración. Nota: Esto solo se aplica cuando el atributo `enableUncPolling` se establece en true. Nota: Este atributo se ha agregado en IIS 7.5. El valor predeterminado es `00:03:00` (tres minutos).
`userName`	Atributo de cadena opcional. Especifica el nombre de usuario para acceder a la ubicación del almacenamiento de archivos de configuración. No existe ningún valor predeterminado.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo de código siguiente se muestra cómo configurar IIS 7 para compartir archivos de configuración y claves de cifrado en un directorio compartido de la red.

<CONFIGURATION>

   <CONFIGSECTIONS>
      <SECTION name="configurationRedirection" />
   </CONFIGSECTIONS>

   <CONFIGPROTECTEDDATA>
      <PROVIDERS>
         <ADD description="Uses RsaCryptoServiceProvider to encrypt and decrypt" name="IISRsaProvider" type="" keyContainerName="iisConfigurationKey" cspProviderName="" useMachineContainer="true" useOAEP="false" />
      </PROVIDERS>
   </CONFIGPROTECTEDDATA>

   <CONFIGURATIONREDIRECTION enabled="true" path="\\ServerName\ShareName" userName="MyUser" password="[enc:IISRsaProvider:57686f6120447564652c2049495320526f636b73:enc]" />

</CONFIGURATION>

Código de ejemplo

En los ejemplos siguientes se habilita la configuración compartida mediante los archivos de configuración exportados que se comparten en \\ServerName\ShareName y mediante un nombre de usuario de "MyUser" con una contraseña de "P@ssw0rd" para acceder al recurso compartido.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetRedirectionConfiguration();
         ConfigurationSection redirectionSection = config.GetSection("configurationRedirection");

         redirectionSection.Attributes["enabled"].Value = true;
         redirectionSection.Attributes["path"].Value = @"\\ServerName\ShareName";
         redirectionSection.Attributes["userName"].Value = @"MyUser";
         redirectionSection.Attributes["password"].Value = @"P@ssw0rd";

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetRedirectionConfiguration
      Dim redirectionSection As ConfigurationSection = config.GetSection("configurationRedirection")
      redirectionSection.Attributes("enabled").Value = True
      redirectionSection.Attributes("path").Value = "\\ServerName\ShareName"
      redirectionSection.Attributes("userName").Value = "MyUser"
      redirectionSection.Attributes("password").Value = "P@ssw0rd"
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

try
{
   var config = WScript.CreateObject( "Microsoft.ApplicationHost.WritableAdminManager" );
   config.CommitPath = "MACHINE/REDIRECTION";
   var section = config.GetAdminSection( "configurationRedirection","MACHINE/REDIRECTION" );
   section.Properties.Item( "enabled" ).Value = true;
   section.Properties.Item( "path" ).Value = "\\\\ServerName\\ShareName";
   section.Properties.Item( "userName" ).Value = "MyUser";
   section.Properties.Item( "password" ).Value = "P@ssw0rd";
   config.CommitChanges();
}
catch(e)
{
   WScript.Echo(e.number); 
   WScript.Echo(e.description);
}

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/REDIRECTION"

Set configurationRedirection = adminManager.GetAdminSection( "configurationRedirection", _
"MACHINE/REDIRECTION" )

configurationRedirection.Properties.Item( "enabled" ).Value = True
configurationRedirection.Properties.Item( "path" ).Value = "\\ServerName\ShareName"
configurationRedirection.Properties.Item( "userName" ).Value = "MyUser"
configurationRedirection.Properties.Item( "password" ).Value = "P@ssw0rd"

adminManager.CommitChanges

Compartir a través de

Configuración de redirección <configurationRedirection>

Información general

Cambios en IIS 7.5

Compatibilidad

Configuración

Procedimientos

Cómo exportar las opciones de configuración y habilitar la configuración compartida

Habilitación de la configuración compartida

Configuración

Atributos

Elementos secundarios

Ejemplo de configuración

Código de ejemplo

C#

VB.NET

JavaScript

VBScript

Comentarios

Recursos adicionales