Proxy 命令

更新:2011 年 1 月

将您的客户端计算机配置为使用代理服务器。 添加、删除并列出有关您的部署(包括任何远程站点)中一个或多个代理服务器的位置和可用性。

所需权限

若要使用 proxy 命令来配置客户端计算机,您必须是本地计算机上**“用户”**安全组的成员。 要使用 proxy 命令以使用代理记录,您必须具有 AdminConfiguration 权限。 有关更多信息,请参见 Team Foundation Server 权限

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 是分配的侦听端口(例如,https://server:8081)。

TeamProjectCollectionUrl

标识团队项目集合。 您必须使用以下格式:http://ApplicationTierServerName:PortNumber/目录/CollectionName。

其中 ApplicationTierServerName 是应用程序层服务器的名称,PortNumber 是分配的侦听端口,以及 Drectory/CollectionName 是目录和集合的名称(例如,https://server:8080/tfs/newcollection1)。

UserName

/login 选项提供值。 可以按域\用户名或用户名的格式来指定用户名值。

Password

为该用户名提供密码。

选项

说明

/configure

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

/collection

指定团队项目集合。

/login

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

/add

将代理记录添加到有关代理服务器在您网路上的位置和可用性的 Visual Studio Team Foundation Server。

/name

将名称与代理记录进行关联。

/site

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

/description

指定该代理记录的描述。

/default

指定该代理记录的范围。 如果您添加默认设置为全局的代理记录,则当开发人员第一次执行 Get 操作时,Team Foundation Server 会将该开发人员的请求重新定向到由该全局记录指定的代理。 如果您添加默认设置为站点的代理记录,则当来自指定 Active Directory 域内的开发人员第一次执行 Get 操作时,Team Foundation Server 会将该开发人员的请求重新定向到由与该站点关联的记录指定的代理。

可以指定以下值之一:

  • global

  • 站点

  • 所有

/delete

从 Team Foundation Server 删除代理记录。

/list

列出 Team Foundation Server 中的代理记录。

/enabled

启用或禁用代理。

  • true

  • false

备注

代理命令有两种用途,每种用途针对不同类型的用户。

作为开发人员,您可以使用代理命令来配置您的客户端以使用代理服务器或重写代理服务器的网络默认值。 此任务类似于将 团队资源管理器 配置为使用代理。

作为网络管理员,您可以使用代理命令添加有关您 Team Foundation Server 部署内的各种代理服务器位置的记录,并对其进行管理。 使用这些记录,您可以帮助开发人员将其工作站配置为使用代理。 如果您定义了全局代理,则 Team Foundation Server 可以自动将开发人员重定向为使用此代理。 如果您有来自不同地理位置的多个 Active Directory 域的复杂网络拓扑,则可以设置多个记录,并将每个记录与特定的域相关联。 这些记录便可以帮助您自动将开发人员从每个地理位置引导至与其位置相应的代理。

有关如何查找**“tf”**命令行实用工具的更多信息,请参见 Tf 命令行实用工具命令

示例

下面的示例会自动检测并将客户端计算机配置为使用代理,前提条件是已经建立了代理记录:

c:\projects>tf proxy /configure

下面的示例会覆盖 Team Foundation Server 上的任何代理记录,并将您的客户端计算机配置为使用指定的代理。

c:\projects>tf proxy /configure Url

下面的示例将全局记录添加到有关此代理的可用性的 Team Foundation Server。 当开发人员第一次执行 Get 操作时,Team Foundation Server 会将该开发人员的所有要求重新定向到指定的代理。

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

下面的示例会将站点记录添加到 Team Foundation Server 中,以便名为 corp 的 Active Directory 域中的开发人员使用此代理服务器。 当来自该域的开发人员第一次执行 Get 操作时,Team Foundation Server 会将该开发人员的所有要求重新定向到指定的代理。

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

请参见

参考

命令行语法(版本控制)

其他资源

Tf 命令行实用工具命令

修订记录

Date

修订记录

原因

2011 年 1 月

新增主题。

信息补充。