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

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando Team Foundation Version Control (TFVC) tf proxy 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 proxy comando para configurar um computador cliente, você deve ser membro do grupo de segurança Usuário no computador local. Para usar o proxy comando 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

Argumento

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 de 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>

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

<password>

Fornece 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 ao Servidor de DevOps do Azure sobre o local e a disponibilidade dos servidores proxy em sua rede.

/name

Associa um nome a um registro de proxy.

/site

Associa um domínio do Ative Directory a um registro proxy.

/description

Especifica uma descrição do registro de proxy.

/default

Especifica o escopo do registro de proxy. Você pode 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 get operação, o Servidor de DevOps do Azure redirecionará essa solicitação para o proxy especificado pelo registro global. Se você adicionar um registro de proxy com o padrão definido como site, na primeira vez que um desenvolvedor de dentro do domínio especificado do Ative Directory fizer uma get operação, o Servidor de DevOps do Azure redirecionará essa solicitação para o proxy especificado pelo registro associado ao site.

/delete

Exclui um registro proxy do Servidor de DevOps do Azure.

/list

Lista registros de proxy no servidor Azure DevOps.

/enabled

Habilita ou desabilita um proxy.

  • true
  • false

Observações

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

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

Como administrador de rede, você pode usar o proxy comando para adicionar e gerenciar registros sobre o local de vários servidores proxy em sua implantação do Azure DevOps Server. 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, o Servidor de DevOps do Azure poderá redirecionar automaticamente os desenvolvedores para usá-lo.

Se você tiver uma topologia de rede complexa com vários domínios do Ative Directory em vários locais geográficos, poderá 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 local geográfico para o proxy apropriado para sua localização.

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

Exemplos

O exemplo a seguir deteta 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 quaisquer 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 Azure DevOps Server sobre a disponibilidade do server proxy. Na primeira vez que um desenvolvedor faz uma get operação, o Servidor de DevOps do Azure 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 de DevOps do Azure para desenvolvedores em um domínio do Ative Directory, chamado corp, para usar esse server proxy. Na primeira vez que um desenvolvedor desse domínio faz uma get operação, 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/