Compartilhar via

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

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

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

Pré-requisitos

Categoria Requirements
Permissões – Para usar o proxy comando para configurar um computador cliente: membro do grupo de segurança do usuário no computador local.
– Para usar o proxy comando para trabalhar com registros de proxy: permissão AdminConfiguration .

Para obter mais informações, consulte o namespace de segurança e a referência de permissão.

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

de argumento

descrição

<url>

Identifica o servidor proxy. Você deve usar o formato http://<proxyServerName>:<proxyPortNumber>, em que 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>

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

<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 do Azure DevOps 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. Você pode especificar um dos seguintes valores:

  • global
  • site
  • all

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

/delete

Exclui um registro de proxy do Servidor do Azure DevOps.

/list

Lista os registros de proxy no servidor do Azure DevOps.

/enabled

Habilita ou desabilita um proxy.

  • true
  • false

Observações

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 para 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, o Servidor do Azure DevOps 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, 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 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 Servidor do Azure DevOps 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 de server. Na primeira vez que um desenvolvedor faz uma operação de 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, chamado corp, para usar esse proxy server. Na primeira vez que um desenvolvedor desse domínio faz uma operação de get, 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:site /site:corp /collection:http://tfsserver:8080/
  • Last updated on