共用方式為

Proxy 命令 （Team Foundation 版本控制）

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制 （TFVC） tf proxy 命令會將用戶端電腦設定為使用 Proxy 伺服器。 此命令會新增、刪除及列出部署中一或多個 Proxy 伺服器的位置和可用性的 Proxy 記錄，包括任何遠端月臺。

必要條件

若要使用 proxy 命令來設定用戶端電腦，您必須是本機電腦上的使用者安全組成員。 若要使用 proxy 命令來處理 Proxy 記錄，您必須具有 管理員 Configuration 許可權。 如需詳細資訊，請參閱 安全性命名空間和許可權參考。

語法

tf proxy ([/configure [Url]) [/collection:TeamProjectCollectionUrl]
[/login:UserName,[Password]]

tf proxy /add Url [/name:Name] [/site:SiteName] 
[/description:Description] [/default:(global|site|all)] 
[/collection:TeamProjectCollectionUrl] [/login:UserName,[Password]] 

tf proxy /delete Url [/collection:TeamProjectCollectionUrl]
[/login:UserName,[Password]] 

tf proxy /list [Url1 Yrl2 ...] 
[/collection:TeamProjectCollectionUrl] [/login:UserName,[Password]]

tf proxy /enabled:(true|false)

參數

引數

Argument

說明

<url>

識別 Proxy 伺服器。 您必須使用 格式 http://<proxyServerName>:<proxyPortNumber>，其中 proxyServerName 是 Proxy 伺服器名稱，而 proxyPortNumber 是指派的接聽埠，例如 http://server:8081。

<TeamProjectCollectionUrl>

識別專案集合。 您必須使用 格式 http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>。 其中 ApplicationTierServerName 是應用層伺服器的名稱、 PortNumber 指派的接聽埠，以及 Directory/CollectionName 目錄和集合的名稱。 例如： http://server:8080/tfs/newcollection1 。

<username>

提供 選項的值 /login 。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。

<password>

提供使用者名稱的密碼。

選項。

選項

說明

/configure

將用戶端電腦設定為使用 Proxy 伺服器。

/collection

指定專案集合。

/login

指定要驗證的使用者名稱和密碼。

/add

將 Proxy 記錄新增至 Azure DevOps Server，以瞭解您網路上 Proxy 伺服器的位置和可用性。

/name

將名稱與 Proxy 記錄產生關聯。

/site

將 Active Directory 網域與 Proxy 記錄產生關聯。

/description

指定 Proxy 記錄的描述。

/default

指定 Proxy 記錄的範圍。 您可以指定下列其中一個值：

  • global
  • site
  • all

如果您將預設設定為 的 Proxy 記錄新增至 global，則第一次開發人員執行 get 作業時，Azure DevOps Server 會將要求重新導向至全域記錄所指定的 Proxy。 如果您將預設設定為 的 Proxy 記錄新增至 site，則第一次從指定 Active Directory 網域內的開發人員執行 get 作業時，Azure DevOps Server 會將要求重新導向至與月台相關聯之記錄所指定的 Proxy。

/delete

從 Azure DevOps Server 刪除 Proxy 記錄。

/list

列出 Azure DevOps 伺服器中的 Proxy 記錄。

/enabled

啟用或停用 Proxy。

  • true
  • false

備註

命令 proxy 有兩個用途，每個用途都是針對不同類型的使用者。

身為開發人員，您可以使用 proxy 命令將用戶端設定為使用 Proxy 伺服器，或覆寫 Proxy 伺服器的網路預設值。 此工作類似於將 Azure DevOps 設定為使用 Proxy。

身為網路管理員，您可以使用 proxy 命令來新增和管理 Azure DevOps Server 部署中各種 Proxy 伺服器位置的相關記錄。 您可以使用這些記錄來協助開發人員設定其工作站以使用 Proxy。 如果您定義全域 Proxy，Azure DevOps Server 可以自動將開發人員重新導向以使用它。

如果您的複雜網路拓撲具有不同地理位置中的多個 Active Directory 網域，您可以設定多個記錄，並將每個記錄與特定網域產生關聯。 然後，這些記錄可協助您自動將開發人員從每個地理位置導向至其位置的適當 Proxy。

如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用Team Foundation版本控制命令。

範例

如果已建立 Proxy 記錄，下列範例會自動偵測並設定用戶端電腦使用 Proxy：

c:\projects>tf proxy /configure

下列範例會覆寫 Azure DevOps Server 上的任何 Proxy 記錄，並設定用戶端計算機使用指定的 Proxy：

c:\projects>tf proxy /configure <Url>

下列範例會將全域記錄新增至 Azure DevOps Server， server 以取得 Proxy 的可用性。 開發人員第一次執行 get 作業時，Azure DevOps Server 會將來自該開發人員的所有要求重新導向至指定的 Proxy。

c:\projects>tf proxy /add http://server:8081 /default:global /collection:http://tfsserver:8080/

下列範例會將網站記錄新增至 Azure DevOps Server， corp以供 Active Directory 網域中的開發人員使用此 server Proxy。 第一次從該網域的開發人員執行 get 作業時，Azure DevOps Server 會將來自該開發人員的所有要求重新導向至指定的 Proxy。

c:\projects>tf proxy /add http://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/