Proxy, commande
Configure votre ordinateur client pour utiliser un serveur proxy. Ajoute, suppressions, et répertorie des enregistrements du proxy à propos de l'emplacement et disponibilité d'un ou plus de serveurs proxy dans votre déploiement, notamment les sites distants.
Autorisations requises
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 avec les enregistrements du proxy, vous devez avoir l'autorisation AdminConfiguration. Pour plus d'informations, consultez Autorisations 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)
Paramètres
Argument |
Description |
---|---|
Url |
Identifie le serveur proxy. Vous devez utiliser le format suivant: http://NomServeurProxy:NuméroPortProxy. Où NomServeurProxy est le nom du serveur proxy et NuméroPortProxy est le port d'écoute assigné (par exemple, https://server:8081). |
TeamProjectCollectionUrl |
Identifie la collection du projet d'équipe. Vous devez utiliser le format suivant: http://NomServeurCoucheApplication:NuméroPort/Répertoire/NomCollection. Où NomServeurCoucheApplication est le nom du serveur de couche Application, le Numéro de port est le port d'écoute assigné, et Drectory/CollectionName sont les noms du répertoire et la collection (par exemple, https://server:8080/tfs/newcollection1). |
UserName |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme Domaine\NomUtilisateur ou NomUtilisateur. |
Password |
Fournit un mot de passe pour le nom d'utilisateur. |
Option |
Description |
---|---|
/configure |
Configure votre ordinateur client pour utiliser un serveur proxy. |
/collection |
Spécifie la collection du projet d'équipe. |
/login |
Spécifie le nom d'utilisateur et le mot de passe d'authentification. |
/add |
Ajoute un enregistrement du proxy à Visual Studio Team Foundation Server relatif à l'emplacement et à la disponibilité des serveurs proxy sur votre réseau. |
/name |
Associe un nom à un enregistrement du proxy. |
/site |
Associe un domaine Active Directory à un enregistrement du proxy. |
/description |
Spécifie une description de l'enregistrement du proxy. |
/default |
Spécifie la portée de l'enregistrement du proxy. Si vous ajoutez un enregistrement du proxy avec l'ensemble par défaut à global, la première fois un développeur exécute une opération Get, Team Foundation Server redirigeront la requête de ce développeur vers le proxy spécifié par l'enregistrement global. Si vous ajoutez un enregistrement du proxy avec l'ensemble par défaut défini sur global, la première fois un développeur dans le domaine Active Directory spécifié exécute une opération Get, Team Foundation Server redirigera la requête de ce développeur vers le proxy spécifié par l'enregistrement associé au site. Vous pouvez spécifier l'une des valeurs suivantes :
|
/delete |
Supprime un enregistrement du proxy dans Team Foundation Server. |
/list |
Répertorie les enregistrements du proxy dans Team Foundation Server. |
/enabled |
Active ou désactive le proxy.
|
Notes
La commande du proxy a deux buts, chacun vise un type d'utilisateur différent.
En tant que développeur, vous pouvez utiliser la commande du proxy pour configurer votre client de manière à utiliser un serveur proxy ou pour remplacer les valeurs par défaut du réseau d'un serveur proxy. Cette tâche est semblable à la configuration de Team Explorer pour utiliser un proxy.
Comme un administrateur réseau, vous pouvez utiliser la commande du proxy pour ajouter et gérer des enregistrements à propos de l'emplacement de différents serveurs proxy dans votre déploiement à Team Foundation Server. Vous pouvez utiliser ces enregistrements pour aider les développeurs à configurer leurs stations de travail dans le but d'utiliser un proxy. Si vous définissez un proxy global, Team Foundation Server peut rediriger automatiquement les développeurs dans le but de l'utiliser. If you have a complex network topology with multiple Active Directory domains in various geographic locations, you can set up multiple records and associate each record with a particular domain. 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 vous aider ensuite à diriger automatiquement les développeurs de chaque emplacement géographique vers le proxy approprié pour leur emplacement.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant détecte et configure automatiquement un ordinateur client pour utiliser un proxy, si un enregistrement du proxy a été établi :
c:\projects>tf proxy /configure
L'exemple suivant substitue tous enregistrements du proxy sur Team Foundation 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 à Team Foundation Server à propos de la disponibilité de ce proxy. La première fois qu'un développeur exécute une opération Get, Team Foundation Server redirige toutes les requêtes de ce développeur au proxy spécifié.
c:\projects>tf proxy /add https://server:8081 /default:global /collection:http://tfsserver:8080/
L'exemple suivant ajoute un enregistrement de site à Team Foundation Server pour les développeurs dans un domaine Active Directory, appelé corp, pour utiliser ce serveur proxy. La première fois qu'un développeur de ce domaine exécute une opération Get, Team Foundation Server redirige toutes les requêtes de ce développeur au proxy spécifié.
c:\projects>tf proxy /add https://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/
Voir aussi
Référence
Syntaxe de ligne de commande (Contrôle de version)
Autres ressources
Commandes de l'utilitaire en ligne de commande Tf
Historique des modifications
Date |
Historique |
Motif |
---|---|---|
Janvier 2011 |
Ajout d'une rubrique. |
Améliorations apportées aux informations. |