Commande proxy (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande Team Foundation Version Control (TFVC) tf proxy configure votre ordinateur client pour qu’il utilise un serveur proxy. La commande ajoute, supprime et répertorie les enregistrements proxy sur l’emplacement et la disponibilité d’un ou plusieurs serveurs proxy au sein de votre déploiement, y compris les sites distants.

Prérequis

Pour utiliser la commande proxy pour configurer un ordinateur client, vous devez être membre du groupe de sécurité utilisateur sur l’ordinateur local. Pour utiliser la commande proxy pour utiliser des enregistrements proxy, vous devez disposer de l’autorisation AdminConfiguration. Pour plus d’informations, consultez Espace de noms de sécurité et la référence d’autorisation.

Syntaxe

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)

Paramètres

Arguments

Argument

Description

<url>

Identifie le serveur proxy. Vous devez utiliser le format http://<proxyServerName>:<proxyPortNumber>, où proxyServerName est le nom du serveur proxy et proxyPortNumber est le port d’écoute affecté, par exemple http://server:8081.

<TeamProjectCollectionUrl>

Identifie la collection de projets. Vous devez utiliser le format http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. où ApplicationTierServerName est le nom du serveur de la couche Application, PortNumber est le port d’écoute affecté et Directory/CollectionName est le nom du répertoire et de la collection. Par exemple : http://server:8080/tfs/newcollection1.

<username>

Fournit une valeur à l’option /login. Vous pouvez spécifier une valeur de nom d’utilisateur en tant que DOMAIN\username ou username.

<password>

Fournit un mot de passe pour le nom d'utilisateur.

Options

Option

Description

/configure

Configure votre ordinateur client pour utiliser un serveur proxy.

/collection

Spécifie la collection de projets.

/login

Spécifie le nom d’utilisateur et le mot de passe à authentifier.

/add

Ajoute un enregistrement proxy à Azure DevOps Server sur l’emplacement et la disponibilité des serveurs proxy sur votre réseau.

/name

Associe un nom à un enregistrement proxy.

/site

Associe un domaine Active Directory à un enregistrement proxy.

/description

Spécifie une description de l’enregistrement proxy.

/default

Spécifie l’étendue de l’enregistrement proxy. Vous pouvez spécifier l'une des valeurs suivantes :

  • global
  • site
  • all

Si vous ajoutez un enregistrement proxy avec la valeur par défaut définie sur global, la première fois qu’un développeur effectue une opération get, Azure DevOps Server redirige cette demande vers le proxy spécifié par l’enregistrement global. Si vous ajoutez un enregistrement proxy avec la valeur par défaut définie sur site, la première fois qu’un développeur à partir du domaine Active Directory spécifié effectue une opération get, Azure DevOps Server redirige cette demande vers le proxy que l’enregistrement associé au site spécifie.

/delete

Supprime un enregistrement proxy d’Azure DevOps Server.

/list

Répertorie les enregistrements proxy dans le serveur Azure DevOps.

/enabled

Active ou désactive un profil.

  • true
  • false

Notes

La commande proxy a deux objectifs, et chaque objectif est destiné à un type d’utilisateur différent.

En tant que développeur, vous pouvez utiliser la commande proxy pour configurer votre client afin d’utiliser un serveur proxy ou de remplacer les valeurs par défaut du réseau pour un serveur proxy. Cette tâche est similaire à la configuration d’Azure DevOps pour utiliser un proxy.

En tant qu’administrateur réseau, vous pouvez utiliser la commande proxy pour ajouter et gérer des enregistrements sur l’emplacement de différents serveurs proxy au sein de votre déploiement d’Azure DevOps Server. Vous pouvez utiliser ces enregistrements pour aider les développeurs à configurer leurs stations de travail pour utiliser un proxy. Si vous définissez un proxy global, Azure DevOps Server peut rediriger automatiquement les développeurs pour l’utiliser.

Si vous avez une topologie de réseau complexe avec plusieurs domaines Active Directory dans différents emplacements géographiques, vous pouvez configurer plusieurs enregistrements et associer chaque enregistrement à un domaine particulier. Ces enregistrements peuvent ensuite vous aider à diriger automatiquement les développeurs de chaque emplacement géographique vers le proxy approprié pour leur emplacement.

Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.

Exemples

L’exemple suivant détecte et configure automatiquement un ordinateur client pour utiliser un proxy, si un enregistrement proxy a été établi :

c:\projects>tf proxy /configure

L’exemple suivant remplace tous les enregistrements proxy sur Azure DevOps Server et configure un ordinateur client pour utiliser un proxy spécifié :

c:\projects>tf proxy /configure <Url>

L’exemple suivant ajoute un enregistrement global à Azure DevOps Server sur la disponibilité du proxy server. La première fois qu’un développeur effectue une opération get, Azure DevOps Server redirige toutes les demandes de ce développeur vers le proxy spécifié.

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

L’exemple suivant ajoute un enregistrement de site à Azure DevOps Server pour les développeurs dans un domaine Active Directory, nommé corp, pour utiliser ce proxy server. La première fois qu’un développeur de ce domaine effectue une opération get, Azure DevOps Server redirige toutes les demandes de ce développeur vers le proxy spécifié.

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