代理命令 （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)
参数
参数
参数
说明
<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
指定代理记录的范围。 可以指定以下值之一：
globalsiteall
如果添加默认设置为 global的代理记录，则开发人员首次执行 get 操作时，Azure DevOps Server 会将请求重定向到全局记录指定的代理。 如果添加默认设置为 site的代理记录，则当开发人员首次从指定的 Active Directory 域内执行 get 操作时，Azure DevOps Server 会将该请求重定向到与站点关联的记录指定的代理。
/delete
从 Azure DevOps Server 中删除代理记录。
/list
列出 Azure DevOps 服务器中的代理记录。
/enabled
启用或禁用代理。
truefalse
言论
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/
以下示例将站点记录添加到 Active Directory 域中的开发人员的 Azure DevOps Server，该域名为 corp，以使用此 server 代理。 首次从该域中的开发人员执行 get 操作时，Azure DevOps Server 会将来自该开发人员的所有请求重定向到指定的代理。
c:\projects>tf proxy /add http://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/