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 命令来处理代理记录，必须具有 AdminConfiguration 权限。 有关详细信息，请参阅安全命名空间和权限参考。

语法

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>

标识代理服务器。 必须使用格式 http://<proxyServerName>:<proxyPortNumber>，其中 proxyServerName 是代理服务器的名称，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

将客户端计算机配置为使用代理服务器。

/collection

指定项目集合。

/login

指定要进行身份验证的用户名和密码。

/add

向 Azure DevOps Server 添加有关代理服务器在网络上的位置和可用性的代理记录。

/name

将名称与代理记录关联。

/site

将 Active Directory 域与代理记录关联。

/description

指定代理记录说明。

/default

指定代理记录的范围。 可以指定以下值之一：

  • global
  • site
  • all

如果添加默认设置为 global 的代理记录，开发人员首次执行 get 操作时，Azure DevOps Server 将该请求重定向到全局记录指定的代理。 如果添加默认设置为 site 的代理记录，指定 Active Directory 域中的开发人员首次执行 get 操作时，Azure DevOps Server 将该请求重定向到与站点关联的记录指定的代理。

/delete

从 Azure DevOps Server 中删除代理记录。

/list

列出 Azure DevOps Server 中的代理记录。

/enabled

启用或禁用代理。

  • true
  • false

注解

proxy 命令有两种用途，每种用途针对不同类型的用户。

开发人员可以使用 proxy 命令将客户端配置为使用代理服务器或替代代理服务器的网络默认值。 此任务类似于将 Azure DevOps 配置为使用代理。

网络管理员可以使用 proxy 命令添加和管理有关 Azure DevOps Server 部署中各种代理服务器位置的记录。 可以使用这些记录来帮助开发人员将其工作站配置为使用代理。 如果定义全局代理，Azure DevOps Server 可以自动重定向开发人员以使用它。

如果有一个复杂的网络拓扑，其中包含不同地理位置的多个 Active Directory 域，可以设置多个记录并将每个记录与特定域关联。 然后，这些记录可帮助将每个地理位置的开发人员自动定向到其所在位置的相应代理。

有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。

示例

如果已建立代理记录，以下示例会自动检测客户端计算机并将其配置为使用代理：

c:\projects>tf proxy /configure

以下示例替代 Azure DevOps Server 上的任何代理记录，并将客户端计算机配置为使用指定的代理：

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

以下示例向 Azure DevOps Server 添加有关 server 代理可用性的全局记录。 开发人员首次执行 get 操作时，Azure DevOps Server 将来自该开发人员的所有请求重定向到指定的代理。

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

以下示例将站点记录添加到 Azure DevOps Server，供名为 corp 的 Active Directory 域中的开发人员使用此 server 代理。 该域中的开发人员首次执行 get 操作时，Azure DevOps Server 将来自该开发人员的所有请求重定向到指定的代理。

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