ConfigureConnections 命令

  • 發行項

更新：2007 年 11 月

使用 ConfigureConnections 命令可以變更 Team Foundation Server 的連接介面。 

重要事項：

在伺服器上使用 ConfigureConnections 命令之後，嘗試連線到伺服器的用戶端電腦仍會使用舊設定進行設定。您必須使用本主題稍後的「備註」一節中所述程序，清除這些電腦的快取或指示使用者如何清除快取。

必要的使用權限

若要使用 ConfigureConnections 命令，則您必須是 Team Foundation 應用程式層伺服器上 Team Foundation Administrators 安全性群組的成員，而且是 Team Foundation 資料層伺服器上 SQL Server sysadmin 安全性群組的成員。如果使用 /proxy 選項，您必須是 Team Foundation 應用程式層和 Proxy 伺服器上的系統管理員。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

注意事項：

即使您已使用管理認證登入，還是必須開啟較高權限的命令提示字元，在執行 Windows Server 2008 的伺服器上執行此函式。若要開啟較高權限的命令提示字元，請按一下 [開始]，以滑鼠右鍵按一下 [命令提示字元]，再按一下 [以系統管理員身分執行]。如需詳細資訊，請參閱 Microsoft 網站 (英文)。

 
TFSAdminUtil ConfigureConnections [/View] [/proxy] [/ClientCertificate :(user|computer)] [/ATUri:<uri>] [/PublicATUri:<uri>] [/SharepointUri:<uri>] [/SharepointSitesUri:<uri>] [/SharepointAdminUri:<uri>] [/SharepointUnc:<unc>] [/ReportsUri:<uri>] [/ReportServerUri:<uri>] [/TswaUri:<uri>]

參數

引數

描述

user

與 /clientcertificate 選項搭配使用，可以指定使用使用者憑證存放區。

computer

與 /clientcertificate 選項搭配使用，可以指定它使用電腦憑證存放區。

URI

與適當選項搭配使用，可以設定 Uniform Resource Indicator (URI)。

選項

描述

/view

顯示 Team Foundation Server 的目前連接設定。

/proxy

針對 Team Foundation Server Proxy 帳戶執行命令。

如果使用 /proxy 選項，則只能搭配 /clientcertificate 選項。

/ClientCertificate

指定要加入憑證的使用者或電腦憑證存放區。

/ATUri

指定應用程式層 Uniform Resource Indicator (URI)。

/PublicATUri

指定電子郵件警示文字中使用的 URI。

/SharepointSitesUri

指定 SharePoint 網站 URI。

/SharepointAdminUri

指定 SharePoint 管理網站 URI。

/SharepointUnc

指定 SharePoint 統一命名慣例 (UNC) 路徑。

/ReportsUri

指定 SQL Server Reporting Services 的 URI。您可以從這個網站中檢視特定 Team Foundation Server 報表。

/ReportServerUri

指定 ReportService.asmx Web 服務的 URI。

/TswaUri

指定各種 Team System Web Access (如果已安裝的話) 之元件的 URI。

備註

重要事項：

建議您在執行 ConfigureConnections 命令之前，備份 Team Foundation Server 資料層伺服器中的資料庫。您也可以先執行加上 /view 選項的命令來檢視現有設定。

ConfigureConnections 命令是提供給想要針對一個或多個 Team Foundation Server 之元件變更組態資訊 (例如伺服器名稱或通訊埠編號) 的系統管理員使用。系統管理員會從應用程式層執行這個工具，以更新所有具有新組態資訊的 Team Foundation 伺服器。

公用程式會更新組態資訊，如下所示：

  • /ATUri 選項會在 Web 服務 web.config 檔、CoverAn.exe.config 檔、TFSServerScheduler.exe.config 檔和 Team Foundation 資料庫中設定組態資訊。

  • /PublicATUri 選項會在 Web 服務 web.config 檔中設定組態資訊。

  • /ClientCertificate 選項會根據引數來開啟使用者或電腦的憑證存放區。使用者指定要使用的憑證之後，這些資訊會設定在 Web 服務 web.config 檔、CoverAn.exe.config 檔和 TFSServerScheduler.exe.config 檔中。

  • /SharePointUri、/SharepointSitesUri、/SharePointUnc 和 /SharepointAdminUri 選項會在 Team Foundation 的資料庫中設定 SharePoint 產品和技術的組態資訊。

  • /Reports 和 /ReportServer 選項會在 Team Foundation 的資料庫中設定 SQL Server Reporting Services 的組態資訊。

  • /TswaUri 選項會設定 Team System Web Access (如果已安裝的話) 的組態資訊。

ConfigureConnections 命令不會清除用戶端電腦上的快取，因此這些電腦可以使用 Team Foundation Server 元件的新組態資訊。在用戶端電腦使用新資訊之前，您必須先手動清除電腦上的快取。

若要在用戶端電腦上清除 Team Foundation 的快取

  1. 使用您想要更新其帳戶的使用者認證登入用戶端電腦，然後關閉任何開啟的 Visual Studio 執行個體。

  2. 開啟瀏覽器，然後視用戶端電腦上執行的作業系統而定，瀏覽到下列其中一個資料夾：

    • Windows XP 或 Windows Server 2003

      Drive**:\Documents and Settings\UserName\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**

    • Windows Vista

      Drive**:\Users\UserName\Application Data\Local\Microsoft\Team Foundation\2.0\Cache**

  3. 刪除 Cache 目錄中的內容，包括所有子資料夾。

  4. 針對存取 Team Foundation Server 之電腦上的每個使用者帳戶，重複這些步驟。

    注意事項：

    您可能會考慮將如何清除快取區的指示，散發給所有 Team Foundation Server 使用者，讓這些使用者自行清除快取區。

範例

下列範例顯示 ATUri、PublicATUri、SharepointUri、SharepointSitesUri、SharepointAdminUri、SharepointUnc、ReportsUri、ReportServerUri 和 TswaUri 的目前值。如果未設定任何值，則輸出會指出尚未設定任何值。

>TFSAdminUtil ConfigureConnections /view

下列範例會將 PublicATUri 設為新值 http://contoso.example.com:8080。

>TFSAdminUtil ConfigureConnections /PublicATUri:http://contoso.example.com:8080

請參閱

其他資源

使用 Team Foundation Server 命令列工具

Team Foundation Server 系統管理員工作

管理 Team Foundation Server 服務和服務帳戶