Configurazione del reindirizzamento della <configurazioneRedirection>

Panoramica

L'elemento <configurationRedirection> consente di condividere i file di configurazione da una posizione centralizzata a più computer server Internet Information Services (IIS) 7 in una Web farm. In questo modo è possibile configurare un server IIS 7 nella Web farm e condividere le impostazioni di configurazione risultanti in tutti i server IIS 7 nella Web farm. Questo elemento consente inoltre di archiviare le impostazioni di configurazione in un server UNC a cui possono accedere tutti i computer server Web della Web farm.

Modifiche in IIS 7.5

In IIS 7.5 sono stati aggiunti due nuovi attributi che controllano se IIS userà notifiche di modifica o polling UNC per determinare se i file di configurazione sono stati modificati. Gli attributi sono:

  • enableUncPolling:

    • Se impostato su true, IIS verificherà periodicamente la condivisione UNC per verificare se i file di configurazione sono stati aggiornati.
    • Se impostato su false, le notifiche di modifica continueranno a essere usate come in IIS 7.0.
  • pollingPeriod: specifica l'intervallo di tempo tra i controlli UNC che IIS userà.

Compatibilità

Versione Note
IIS 10.0 L'elemento <configurationRedirection> non è stato modificato in IIS 10.0.
IIS 8,5 L'elemento <configurationRedirection> non è stato modificato in IIS 8.5.
IIS 8,0 L'elemento <configurationRedirection> non è stato modificato in IIS 8.0.
IIS 7,5 Gli enableUncPolling attributi e pollingPeriod sono stati aggiunti in IIS 7.5.
IIS 7.0 L'elemento <configurationRedirection> è stato introdotto in IIS 7.0.
IIS 6.0 IIS 6.0 non supporta la configurazione condivisa.

Installazione

L'elemento <configurationRedirection> è incluso nell'installazione predefinita di IIS 7.

Procedure

Come esportare le impostazioni di configurazione e abilitare la configurazione condivisa

  1. Aprire Gestione Internet Information Services (IIS):

    • Se si usa Windows Server 2012 o Windows Server 2012 R2:

      • Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).
    • Se si usa Windows 8 o Windows 8.1:

      • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
      • Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
    • Se si usa Windows Server 2008 o Windows Server 2008 R2:

      • Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).
    • Se si usa Windows Vista o Windows 7:

      • Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
      • Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
  2. Nel riquadro Connessioni fare clic sulla connessione server per cui si vuole configurare il reindirizzamento della configurazione.

  3. Nel riquadro Home fare doppio clic su Configurazione condivisa.
    Screenshot del riquadro Home del manager di I S. Icona Configurazione condivisa selezionata.

  4. Nel riquadro Azioni fare clic su Esporta configurazione
    Screenshot del riquadro Azioni di I S Manager.

  5. Nella finestra di dialogo Esporta configurazione digitare il percorso della directory in cui si desidera esportare i file di configurazione nella casella Percorso fisico digitare e confermare la password di crittografia, quindi fare clic su OK.
    Screenshot della finestra Esporta configurazione.

  6. Quando viene visualizzata la finestra di dialogo Esporta configurazione, fare clic su OK.
    Screenshot della finestra di dialogo Esporta configurazione.

Come abilitare la configurazione condivisa

  1. Aprire Gestione Internet Information Services (IIS):

    • Se si usa Windows Server 2012 o Windows Server 2012 R2:

      • Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).
    • Se si usa Windows 8 o Windows 8.1:

      • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
      • Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
    • Se si usa Windows Server 2008 o Windows Server 2008 R2:

      • Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).
    • Se si usa Windows Vista o Windows 7:

      • Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
      • Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
  2. Nel riquadro Connessioni fare clic sulla connessione server per cui si vuole configurare il reindirizzamento della configurazione.

  3. Nel riquadro Home fare doppio clic su Configurazione condivisa.
    Screenshot del riquadro Home con l'icona Configurazione condivisa evidenziata.

  4. Nel riquadro Configurazione condivisa selezionare l'opzione Abilita configurazione condivisa .

  5. Nella casella Percorso fisico digitare il percorso dei file di configurazione condivisi, digitare il nome dell'account con le autorizzazioni per accedere ai file di configurazione condivisi nella casella Nome utente , digitare la password dell'account nella casella Password e quindi digitare di nuovo la password dell'account nella casella Conferma password .
    Screenshot della finestra Configurazione condivisa.

  6. Nel riquadro Azioni fare clic su Applica.

  7. Nella finestra di dialogo Immettere la password della chiave di crittografia della finestra di dialogo Password chiavi di crittografia digitare la password per la chiave di crittografia creata nel passaggio 5 e quindi fare clic su OK.
    Screenshot della casella password della chiave di crittografia.

  8. In ogni finestra di dialogo Configurazione condivisa visualizzata fare clic su OK per chiudere le finestre di dialogo.
    Screenshot della finestra di dialogo di configurazione condivisa sulle chiavi eccryption I S esistenti.
    Screenshot della finestra di dialogo di configurazione condivisa relativa al riavvio di I S Manager.

    Nota

    Prima di riflettere queste modifiche di configurazione, è necessario chiudere e riavviare Gestione IIS.

Configurazione

L'elemento <configurationRedirection> è configurato nel file Redirection.config.

Attributi

Attributo Descrizione
enabled Attributo booleano facoltativo.

Specifica se il reindirizzamento della configurazione è abilitato o disabilitato nel server Web.

Il valore predefinito è false.
enableUncPolling Attributo booleano facoltativo.

true se il polling UNC deve essere utilizzato per verificare se i file di configurazione sono stati aggiornati; in caso contrario, false se è necessario usare le notifiche di modifica. Nota: l'intervallo di tempo tra i controlli viene configurato dall'attributo pollingPeriod .

Nota: Questo attributo è stato aggiunto in IIS 7.5.

Il valore predefinito è false.
password Attributo stringa facoltativo.

Specifica la password che è necessario autenticare il nome utente per accedere al percorso per l'archiviazione dei file di configurazione. Si tratta di una stringa con distinzione tra maiuscole e minuscole.

Nota: Per evitare di archiviare stringhe password non crittografate nei file di configurazione, usare sempre AppCmd.exe o Gestione IIS per immettere le password. Se si usano questi strumenti di gestione, le stringhe password verranno crittografate automaticamente prima che vengano scritte nei file di configurazione XML. Ciò garantisce una migliore sicurezza delle password rispetto all'archiviazione di password non crittografate.
path Attributo stringa facoltativo.

Specifica il percorso da cui leggere i file di configurazione e le chiavi di crittografia. Può trattarsi di un percorso di rete o di una cartella nel computer locale.

Non è previsto alcun valore predefinito.
pollingPeriod Attributo timeSpan facoltativo.

Specifica l'intervallo di tempo tra i controlli che IIS userà per verificare se i file di configurazione sono stati aggiornati. Nota: questo vale solo quando l'attributo enableUncPolling è impostato su true.

Nota: Questo attributo è stato aggiunto in IIS 7.5.

Il valore predefinito è 00:03:00 (tre minuti).
userName Attributo stringa facoltativo.

Specifica il nome utente per accedere al percorso per l'archiviazione file di configurazione.

Non è previsto alcun valore predefinito.

Elementi figlio

Nessuno.

Esempio di configurazione

Nell'esempio di codice seguente viene illustrato come configurare IIS 7 per condividere i file di configurazione e le chiavi di crittografia in una directory condivisa nella rete.

<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>

Codice di esempio

Gli esempi seguenti consentono la configurazione condivisa usando i file di configurazione esportati condivisi in \\ServerName\ShareNamee usando un nome utente "MyUser" con una password di "P@ssw0rd" per accedere alla condivisione.

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