Compartilhar via


Comando de proxy

Configura o computador cliente para usar um servidor proxy. Adiciona, exclui e lista registros de proxy sobre o local e a disponibilidade de um ou mais servidores proxy dentro de sua implantação, incluindo os sites remotos.

Permissões necessárias

Para usar o proxy de comando para configurar um computador cliente, você deve ser um membro da usuário o grupo de segurança no computador local. Para usar o proxy de comando para trabalhar com registros de proxy, você deve ter a permissão AdminConfiguration. For more information, see Permissões de 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)

Parâmetros

Argument

Description

Url

Identifica o servidor proxy. Você deve usar o seguinte formato: http://proxyServerName:proxyPortNumber.

Onde proxyServerName é o nome do servidor proxy e proxyPortNumber é a porta de escuta atribuída (por exemplo, https://server:8081).

TeamProjectCollectionUrl

Identifica a coleção de projeto de equipe. Você deve usar o seguinte formato: http://ApplicationTierServerName:PortNumber/diretório/NomeDaColeta.

Onde ApplicationTierServerName é o nome do servidor de camada de aplicativo, PortNumber é a porta de escuta atribuída, e Drectory/NomeDaColeta são os nomes de diretório e a coleção (por exemplo, https://server:8080/tfs/newcollection1).

UserName

Fornece um valor para o /login opção. Você pode especificar um valor de nome de usuário como domínio\nome de usuário ou nome de usuário.

Password

Fornece uma senha para o nome de usuário.

Option

Description

/configure

Configura o computador cliente para usar um servidor proxy.

/collection

Especifica a coleção de projeto de equipe.

/login

Especifica o nome de usuário e senha para autenticar.

/add

Adiciona um registro de proxy para Visual Studio Team Foundation Server sobre o local e a disponibilidade dos servidores de proxy na rede.

/name

Associa um nome de um registro de proxy.

/site

Associa a um domínio do Active Directory um registro de proxy.

/description

Especifica uma descrição do registro do proxy.

/default

Especifica o escopo do registro de proxy. Se você adicionar um registro de proxy com o conjunto padrão global, na primeira vez que um desenvolvedor realiza uma operação get, Team Foundation Server redirecionará a solicitação do desenvolvedor para o proxy, que é especificado pelo registro global. Se você adicionar um registro de proxy com o padrão definido para o site, na primeira vez que um desenvolvedor de dentro do domínio especificado do Active Directory executa uma operação get, Team Foundation Server redirecionará a solicitação do desenvolvedor para o proxy, que é especificado pelo registro está associado ao site.

You can specify one of the following values:

  • global

  • site

  • todos os

/delete

Exclui um registro de proxy do Team Foundation Server.

/list

Lista de registros de proxy no Team Foundation Server.

/enabled

Ativa ou desativa o proxy.

  • True

  • FALSO

Comentários

O comando de proxy tem duas finalidades e cada objetivo destina-se a um tipo de usuário diferente.

Como desenvolvedor, você pode usar o comando de proxy para configurar o cliente para usar um servidor proxy ou para substituir os padrões de rede para um servidor proxy. Esta tarefa é semelhante à configuração de Team Explorer para usar um proxy.

Como um administrador de rede, você pode usar o comando de proxy para adicionar e gerenciar registros sobre a localização de vários servidores de proxy dentro de sua implantação de Team Foundation Server. Você pode usar esses registros para ajudar os desenvolvedores a configurar suas workstations para usar um proxy. Se você definir um proxy global, Team Foundation Server pode redirecionar automaticamente os desenvolvedores a usá-lo. Se você tiver uma topologia de rede complexos com vários domínios do Active Directory em vários locais geográficos, você pode configurar vários registros e associar a um domínio específico de cada registro. Esses registros, em seguida, podem ajudar a direcionar automaticamente os desenvolvedores em cada localização geográfica para o proxy apropriado para sua localização.

Para obter mais informações sobre como encontrar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.

Examples

O exemplo a seguir automaticamente detecta e configura um computador cliente para usar um proxy se estabeleceu um registro de proxy:

c:\projects>tf proxy /configure

O exemplo a seguir substitui quaisquer registros de proxy no Team Foundation Server e configura um computador cliente para usar um proxy especificado:

c:\projects>tf proxy /configure Url

O exemplo a seguir adiciona um registro global para Team Foundation Server sobre a disponibilidade de proxy. Na primeira vez que um desenvolvedor realiza uma operação get, Team Foundation Server irá redirecionar todas as solicitações desse desenvolvedor proxy especificado.

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

O exemplo a seguir adiciona um registro de site para Team Foundation Server para os desenvolvedores em um domínio do Active Directory, que é chamado corp, para usar este servidor proxy. Na primeira vez que um desenvolvedor desse domínio executa uma operação get, Team Foundation Server irá redirecionar todas as solicitações desse desenvolvedor proxy especificado.

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

Consulte também

Referência

Sintaxe de linha de comando (controle de versão)

Outros recursos

Comandos do utilitário de linha de comando do TF

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Tópico adicional.

Aprimoramento de informações.