ConfigureConnections, commande

Article
08/22/2008

Mise à jour : novembre 2007

Utilisez la commande ConfigureConnections pour modifier l'interface de connexion de Team Foundation Server.

Remarque importante :
Une fois que vous avez utilisé la commande ConfigureConnections sur le serveur, les ordinateurs clients qui tentent de s'y connecter sont encore configurés avec les anciens paramètres. Vous devez effacer les caches de ces ordinateurs ou demander aux utilisateurs d'effacer les caches en suivant la procédure décrite à la section Notes dans cette rubrique.

Autorisations requises

Pour utiliser la commande ConfigureConnections, vous devez être membre du groupe de sécurité Team Foundation Administrators sur le serveur de couche Application de Team Foundation et membre du groupe de sécurité sysadmin pour SQL Server du serveur de couche Données de Team Foundation. Si vous utilisez l'option /proxy, vous devez être administrateur sur les serveurs proxy et de couche Application de Team Foundation. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Remarque :
Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec les autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec les autorisations élevées, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez le site Web de Microsoft (en anglais).

Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec les autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec les autorisations élevées, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez le site Web de Microsoft (en anglais).

TFSAdminUtil ConfigureConnections [/View] [/proxy] [/ClientCertificate :(user|computer)] [/ATUri:<uri>] [/PublicATUri:<uri>] [/SharepointUri:<uri>] [/SharepointSitesUri:<uri>] [/SharepointAdminUri:<uri>] [/SharepointUnc:<unc>] [/ReportsUri:<uri>] [/ReportServerUri:<uri>] [/TswaUri:<uri>]

Paramètres

Argument	Description
user	Associez-le à l'option /clientcertificate pour lui demander d'utiliser le magasin de certificats de l'utilisateur.
computer	Associez-le à l'option /clientcertificate pour lui demander d'utiliser le magasin de certificats de l'ordinateur.
URI	Utilisez ce paramètre pour définir l'identificateur URI (uniform resource indicator) avec l'option appropriée.

Option	Description
/view	Affiche les paramètres de connexion actuels pour Team Foundation Server.
/proxy	Exécute la commande pour le compte Team Foundation Server proxy. Seule l'option /clientcertificate peut-être utilisée avec l'option /proxy.
/ClientCertificate	Spécifie le magasin de certificats de l'utilisateur ou de l'ordinateur auquel vous souhaitez ajouter un certificat.
/ATUri	Spécifie l'identificateur URI (uniform resource indicator) de couche Application.
/PublicATUri	Spécifie l'URI à utiliser dans le texte d'alertes de messagerie électronique.
/SharepointSitesUri	Spécifie l'URI du site SharePoint.
/SharepointAdminUri	Spécifie l'URI du site administratif SharePoint.
/SharepointUnc	Spécifie le chemin UNC (Convention d'affectation de noms uniforme) de SharePoint.
/ReportsUri	Spécifie l'URI de SQL Server Reporting Services. Vous pouvez afficher des rapports de Team Foundation Server spécifiques depuis ce site.
/ReportServerUri	Spécifie l'URI du service Web ReportService.asmx.
/TswaUri	Spécifie les URI de différents composants de Team System Web Access, s'il est installé.

Notes

Remarque importante :
Nous vous recommandons de sauvegarder les bases de données dans le serveur de couche Données de Team Foundation Server avant d'exécuter la commande ConfigureConnections. Il est également utile d'exécuter la commande à l'aide de l'option /view pour consulter d'abord les paramètres existants.

La commande ConfigureConnections est utilisée par un administrateur qui souhaite modifier les informations de configuration, telles que le nom du serveur ou le numéro de port, d'un ou de plusieurs composants de Team Foundation Server. L'administrateur exécute cet outil à partir de couche Application pour mettre à jour tous les serveurs de Team Foundation qui ont les nouvelles informations de configuration.

L'utilitaire met à jour les informations de configuration comme suit :

L'option /ATUri définit des informations de configuration dans le fichier web.config des services Web, le fichier CoverAn.exe.config, le fichier TFSServerScheduler.exe.config et la base de données de Team Foundation.
L'option /PublicATUri définit des informations de configuration dans le fichier web.config des services Web.
L'option /ClientCertificate ouvre le magasin de certificats pour l'utilisateur ou l'ordinateur, en fonction de l'argument. Après avoir spécifié un certificat à utiliser, les informations sont définies dans le fichier web.config des services Web, le fichier CoverAn.exe.config et le fichier TFSServerScheduler.exe.config.
Les options /SharePointUri/SharepointSitesUri, /SharePointUnc et /SharepointAdminUri définissent les informations de configuration de produits et technologies SharePoint dans la base de données de Team Foundation.
Les options /Reports et /ReportServer définissent les informations de configuration de SQL Server Reporting Services dans la base de données de Team Foundation.
L'option /TswaUri définit les informations de configuration de Team System Web Access, s'il est installé.

La commande ConfigureConnections n'efface pas les caches sur les ordinateurs clients afin qu'ils puissent utiliser les nouvelles informations de configuration pour les composants de Team Foundation Server. Pour que les ordinateurs clients puissent utiliser les nouvelles informations, vous devez d'abord effacer manuellement leur cache.

Pour effacer le cache d'un ordinateur client pour Team Foundation

Connectez-vous à l'ordinateur client en utilisant les informations d'identification de l'utilisateur dont vous souhaitez mettre à jour le compte, puis fermez toutes les instances ouvertes de Visual Studio.
Ouvrez un navigateur et accédez à l'un des dossiers suivants, selon le système d'exploitation exécuté sur l'ordinateur client :
- Windows XP ou Windows Server 2003
  
  Lecteur**:\Documents and Settings\NomUtilisateur\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**
- Windows Vista
  
  Lecteur**:\Users\NomUtilisateur\Application Data\Local\Microsoft\Team Foundation\2.0\Cache**
Supprimez le contenu du répertoire Cache, y compris tous les sous-dossiers.

Répétez ces étapes pour chaque compte d'utilisateur de l'ordinateur qui accède à Team Foundation Server.

Remarque :
Vous souhaitez peut-être fournir des instructions sur la manière d'effacer le cache à tous vos utilisateurs de Team Foundation Server afin qu'ils puissent effectuer eux-mêmes cette procédure.

Exemple

L'exemple suivant affiche les valeurs actuelles de ATUri, PublicATUri, SharepointUri, SharepointSitesUri, SharepointAdminUri, SharepointUnc, ReportsUri, ReportServerUri et TswaUri. Si aucune valeur n'est définie, la sortie l'indique.

>TFSAdminUtil ConfigureConnections /view

L'exemple suivant affecte la nouvelle valeur http://contoso.example.com:8080 à PublicATUri.

>TFSAdminUtil ConfigureConnections /PublicATUri:http://contoso.example.com:8080

Voir aussi

Autres ressources

Utilisation des outils de ligne de commande Team Foundation Server

Administration de Team Foundation Server

Gestion des services et comptes de service Team Foundation Server

Partager via