Comando proxy (Controle de Versão do Team Foundation)

  • Artigo

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

Visual Studio 2019 | Visual Studio 2022

O comando tf proxy TFVC (Controle de Versão do Team Foundation) configura o computador cliente para usar um servidor proxy. O comando adiciona, exclui e lista registros de proxy sobre o local e a disponibilidade de um ou mais servidores proxy em sua implantação, incluindo quaisquer sites remotos.

Pré-requisitos

Para usar o comando proxy para configurar um computador cliente, você deve ser membro do grupo de segurança do usuário no computador local. Para usar o comando proxy para trabalhar com registros proxy, você deve ter a permissão AdminConfiguration. Para obter mais informações, consulte Referência de permissão e namespace de segurança.

Sintaxe

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

Argumentos

Argument

Descrição

<url>

Identifica o servidor proxy. Você deve usar o formato http://<proxyServerName>:<proxyPortNumber>, onde proxyServerName é o nome do servidor proxy e proxyPortNumber é a porta de escuta atribuída, por exemplo http://server:8081.

<TeamProjectCollectionUrl>

Identifica a coleção de projetos. Você deve usar o formato http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. onde ApplicationTierServerName é o nome do servidor da camada de aplicativo, PortNumber é a porta de escuta atribuída e Directory/CollectionName são os nomes do diretório e da coleção. Por exemplo, http://server:8080/tfs/newcollection1.

<username>

Mostra um valor para a opção /login. Você pode especificar um valor de nome de usuário como DOMAIN\username ou username.

<password>

Uma senha para o nome de usuário.

Opções

Opção

Descrição

/configure

Configura o computador cliente para usar um servidor proxy.

/collection

Especifica a coleção de projetos.

/login

Especifica o nome de usuário e a senha a serem autenticados.

/add

Adiciona um registro de proxy a Azure DevOps Server sobre a localização e a disponibilidade de servidores proxy em sua rede.

/name

Associa um nome a um registro de proxy.

/site

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

/description

Especifica uma descrição do registro de proxy.

/default

Especifica o escopo do registro de proxy. É possível especificar um dos seguintes valores:

  • global
  • site
  • all

Se você adicionar um registro de proxy com o padrão definido como global, na primeira vez que um desenvolvedor fizer uma operação get, o Azure DevOps Server redirecionará essa solicitação para o proxy especificado pelo registro global. Se você adicionar um registro de proxy com o conjunto padrão como site, na primeira vez que um desenvolvedor de dentro do domínio do Active Directory especificado fizer uma operação get, o Servidor do Azure DevOps redirecionará essa solicitação para o proxy que o registro associado ao site especifico.

/delete

Exclui um registro de proxy do Azure DevOps Server.

/list

Lista os registros de proxy no servidor do Azure DevOps.

/enabled

Habilita ou desabilita um proxy.

  • true
  • false

Comentários

O comando proxy tem duas finalidades e cada finalidade é destinada a um tipo diferente de usuário.

Como desenvolvedor, você pode usar o comando proxy a fim de configurar seu cliente para usar um servidor proxy ou substituir os padrões de rede para um servidor proxy. Essa tarefa é semelhante à configuração do Azure DevOps para usar um proxy.

Como administrador de rede, você pode usar o comando proxy para adicionar e gerenciar registros sobre a localização de vários servidores proxy na implantação do Servidor do Azure DevOps. Você pode usar esses registros para ajudar os desenvolvedores a configurar suas estações de trabalho para usar um proxy. Se você definir um proxy global, Azure DevOps Server poderá redirecionar automaticamente os desenvolvedores para usá-lo.

Se você tiver uma topologia de rede complexa com vários domínios do Active Directory em várias localizações geográficas, é possível configurar vários registros e associar cada registro a um domínio específico. Esses registros podem ajudá-lo a direcionar automaticamente os desenvolvedores de cada localização geográfica para o proxy apropriado para sua localização.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

O exemplo a seguir detecta e configura automaticamente um computador cliente para usar um proxy, se um registro de proxy tiver sido estabelecido:

c:\projects>tf proxy /configure

O exemplo a seguir substitui todos os registros de proxy no Azure DevOps 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 ao Servidor do Azure DevOps sobre a disponibilidade do proxy server. Na primeira vez que um desenvolvedor faz uma operação get, o Azure DevOps Server redireciona todas as solicitações desse desenvolvedor para o proxy especificado.

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

O exemplo a seguir adiciona um registro de site ao Servidor do Azure DevOps para desenvolvedores em um domínio do Active Directory, que é chamado corp, para usar esse proxy server. Na primeira vez que um desenvolvedor daquele domínio faz uma operação get, o Azure DevOps Server redireciona todas as solicitações desse desenvolvedor para o proxy especificado.

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