組態重新 < 導向組態重新導向>

發行項
2023/07/19

概觀

元素 <configurationRedirection> 可讓您將組態檔從集中式位置共用到多個 Internet Information Services (IIS) 7 部伺服器陣列中的伺服器電腦。這可讓您在 Web 服務器陣列中設定一部 IIS 7 伺服器，並在 Web 服務器陣列中的所有 IIS 7 伺服器之間共用產生的組態設定。這個專案也可讓您將組態設定儲存在 Web 服務器陣列中所有 Web 服務器電腦可以存取的 UNC 伺服器上。

IIS 7.5 中的變更

在 IIS 7.5 中，已新增兩個新屬性，以控制 IIS 是否會使用變更通知或 UNC 輪詢來判斷組態檔是否已變更。這些屬性包括：

enableUncPolling:
- 當設定為 true時，IIS 會定期檢查 UNC 共用，以測試組態檔是否已更新。
- 當設定為 false時，變更通知會繼續使用，因為它們在 IIS 7.0 中。
pollingPeriod：指定 IIS 將使用之 UNC 檢查之間的時間間隔。

相容性

版本	備註
IIS 10.0	在 `<configurationRedirection>` IIS 10.0 中未修改專案。
IIS 8.5	未 `<configurationRedirection>` 在 IIS 8.5 中修改專案。
IIS 8.0	在 IIS 8.0 中未修改專案 `<configurationRedirection>` 。
IIS 7.5	`enableUncPolling`和 `pollingPeriod` 屬性已在 IIS 7.5 中新增。
IIS 7.0	專案 `<configurationRedirection>` 是在 IIS 7.0 中引進的。
IIS 6.0	IIS 6.0 不支援共用設定。

安裝程式

專案 <configurationRedirection> 包含在 IIS 7 的預設安裝中。

作法

如何匯出組態設定並啟用共用設定

(IIS) 管理員開啟 Internet Information Services：
- 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：
  - 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。
- 如果您使用 Windows 8 或 Windows 8.1：
  - 按住Windows鍵，按字母X，然後按一下[主控台]。
  - 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。
- 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：
  - 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。
- 如果您使用 Windows Vista 或 Windows 7：
  - 在工作列上，按一下 [開始]，然後按一下[主控台]。
  - 按兩下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。
在 [ 連線 ] 窗格中，按一下您要設定組態重新導向的伺服器連線。
在 [ 首頁] 窗格中，按兩下 [共用組態]。
在 [ 動作] 窗格中，按一下 [ 匯出組態]
在 [ 匯出組態 ] 對話方塊中，輸入您要在 [實體路徑 ] 方塊中匯出組態檔之目錄的路徑，輸入並確認加密密碼，然後按一下 [ 確定]。
當 [匯出組態] 對話方塊出現時，按一下 [ 確定]。

如何啟用共用設定

(IIS) 管理員開啟 Internet Information Services：
- 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：
  - 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。
- 如果您使用 Windows 8 或 Windows 8.1：
  - 按住Windows鍵，按字母X，然後按一下[主控台]。
  - 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。
- 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：
  - 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。
- 如果您使用 Windows Vista 或 Windows 7：
  - 在工作列上，按一下 [開始]，然後按一下[主控台]。
  - 按兩下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。
在 [ 連線 ] 窗格中，按一下您要設定組態重新導向的伺服器連線。
在 [ 首頁] 窗格中，按兩下 [共用組態]。
在 [ 共用組態] 窗格中，選取 [ 啟用共用組態 ] 選項。
在 [實體路徑 ] 方塊中，輸入共用組態檔的路徑、在 [ 使用者名稱 ] 方塊中輸入有權存取共用組態檔的帳戶名稱、在 [ 密碼 ] 方塊中輸入帳戶的密碼，然後在 [ 確認密碼 ] 方塊中再次輸入帳戶密碼。
在 [動作] 窗格中，按一下 [套用]。
在 [加密金鑰密碼] 對話方塊的 [輸入加密金鑰密碼] 方塊中，輸入您在步驟 5 中建立之加密金鑰的密碼，然後按一下 [確定]。
在每個出現的 [ 共用組態 ] 對話方塊中，按一下 [ 確定 ] 以關閉對話方塊。

注意

您必須先關閉並重新啟動 IIS 管理員，才能反映這些設定變更。

組態

專案 <configurationRedirection> 是在 Redirection.config 檔案中設定。

屬性

屬性	描述
`enabled`	選擇性的 Boolean 屬性。指定在 Web 服務器上啟用或停用組態重新導向。預設值是 `false`。
`enableUncPolling`	選擇性的 Boolean 屬性。如果應該使用 UNC 輪詢來檢查組態檔是否已更新，則為true;否則，如果應該使用變更通知，則為false。注意：檢查之間的時間間隔是由屬性所設定 `pollingPeriod` 。注意：這個屬性已在 IIS 7.5 中新增。預設值是 `false`。
`password`	選擇性字串屬性。指定驗證使用者名稱以存取組態檔儲存體位置所需的密碼。這是區分大小寫的字串。注意：若要避免在組態檔中儲存未加密的密碼字串，請一律使用 AppCmd.exe 或 IIS 管理員來輸入密碼。如果您使用這些管理工具，密碼字串將會在寫入 XML 組態檔之前自動加密。這提供比儲存未加密密碼更好的密碼安全性。
`path`	選擇性字串屬性。指定要從中讀取組態檔和加密金鑰的位置。這可以是本機電腦上的網路路徑或資料夾。沒有任何預設值。
`pollingPeriod`	選擇性 timeSpan 屬性。指定 IIS 用來檢查組態檔是否已更新的時間間隔。注意：只有在屬性設定為true時 `enableUncPolling` ，才會套用此專案。注意：這個屬性已在 IIS 7.5 中新增。預設值為 `00:03:00` 三分鐘 (。)
`userName`	選擇性字串屬性。指定要存取組態檔儲存體位置的使用者名稱。沒有任何預設值。

子元素

無。

組態範例

下列程式碼範例示範如何將 IIS 7 設定為將組態檔和加密金鑰共用至網路上的共用目錄。

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

範例程式碼

下列範例會使用在 \\ServerName\ShareName 共用的匯出組態檔，以及使用「MyUser」的使用者名稱搭配「P@ssw0rd」密碼來存取共用，來啟用共用組態。

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

AI Skills Fest

共用方式為