ChangeAccount, commande

Article
08/22/2008

Mise à jour : novembre 2007

Utilisez la commande ChangeAccount pour modifier les paramètres de compte et de mot de passe pour tous les comptes de service. Pour plus d'informations, consultez Gestion des services et comptes de service Team Foundation Server.

Autorisations requises

Pour utiliser la commande ChangeAccount, 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 sur SQL Server sur le serveur de couche Données de Team Foundation. Si vous utilisez l'option /proxy, vous devez être administrateur sur les serveur de couche Application de Team Foundation et de couche Données ou le serveur proxy. 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 ChangeAccount [/ra] [/proxy] oldacct newacct newpwd [emailAddress]

Paramètres

Argument	Description
oldacct	Spécifie l'ancien nom du compte.
newacct	Spécifie le nouveau nom du compte.
newpwd	Spécifie le nouveau mot de passe du compte. Non requis pour les comptes systèmes.
emailAddress	Facultatif. Spécifie la nouvelle adresse de messagerie électronique depuis laquelle les alertes sont envoyées. N'utilisez pas cet argument avec l'option /ra.

Option	Description
/ra	Spécifie que les paramètres de compte et de mot de passe sont modifiés pour le compte de service Reporting Services. Si cette option n'est pas fournie, les paramètres de compte et de mot de passe sont modifiés pour le compte de service de Team Foundation Server.
/proxy	Spécifie que les paramètres de compte et de mot de passe sont modifiés pour le compte de Team Foundation Server proxy.

/ra

Spécifie que les paramètres de compte et de mot de passe sont modifiés pour le compte de service Reporting Services.

Si cette option n'est pas fournie, les paramètres de compte et de mot de passe sont modifiés pour le compte de service de Team Foundation Server.

/proxy

Spécifie que les paramètres de compte et de mot de passe sont modifiés pour le compte de Team Foundation Server proxy.

Notes

Remarque importante :
Nous vous recommandons de sauvegarder les bases de données dans le serveur de couche Données de Team Foundation Server.

La commande ChangeAccount est utilisée par un administrateur qui souhaite remplacer le compte de service, par exemple, MyLocation\TFSSERVICE, par un autre compte de service pré-créé tel que MyLocation\tfssvc.

Avant d'assigner un nouveau compte de domaine ou de groupe de travail à l'aide de la commande TFSAdminUtil ChangeAccount, le compte doit disposer de l'autorisation account is sensitive and cannot be delegated sur le serveur de couche Application. Pour plus d'informations, consultez le site Web Microsoft (en anglais).

L'utilitaire met à jour les comptes de service comme suit :

Modifie les nouvelles informations de compte pour les pools d'applications sur la couche Application de Team Foundation. Cette étape est ignorée si l'option /ra est spécifiée. Le pool d'applications est redémarré individuellement par l'utilitaire. Il n'est pas nécessaire de redémarrer les services IIS (Internet Information Services) manuellement.
Modifie les services dans la base de données de Team Foundation. Assigne le nouveau compte au même groupe de rôles que l'ancien compte, TFSExec. Cela garantit que les autorisations sont conservées et qu'il n'y a pas d'indisponibilité de SQL Server sur la couche Données. Il est possible que l'ancien compte d'utilisateur doive être supprimé manuellement de couche Données après une modification réussie des comptes. Par exemple, si vous avez spécifié l'ancien compte de manière incorrecte, le système ne peut pas le supprimer.
Met à jour et redémarre les services Visual Studio Team Foundation Server Task Scheduler et CoverAn pour que les modifications entrent en vigueur. Cette étape est ignorée si l'option /ra est spécifiée.
Ajoute l'autorisation Ouvrir une session en tant que service au nouveau compte et supprime cette autorisation de l'ancien compte (pour les comptes de domaine et de groupe de travail uniquement). Cette étape est ignorée si l'option /ra est spécifiée.
Met à jour les sources de données Reporting Services avec les informations du compte de service Reporting Services. Cette étape est effectuée uniquement si l'option /ra est spécifiée.

Pour plus d'informations, consultez Planificateur de tâches Visual Studio Team Foundation Server. Pour un service de build, le compte et le mot de passe doivent être modifiés manuellement. Pour plus d'informations, consultez Comment : changer le mot de passe du service Visual Studio Team Foundation Build.

Si vous avez spécifié un compte de messagerie, la messagerie électronique d'où proviennent les alertes est également modifiée.

Exemple

L'exemple suivant affiche que la syntaxe utilisée pour mettre à jour les comptes de service. L'utilitaire échange toutes les instances de l'ancien compte, MyOldAcct, avec un nouveau compte, MyNewAcct et un nouveau mot de passe, newPass. L'utilitaire parcourt les comptes de service et modifie uniquement ceux qui s'exécutent sous l'ancien compte.

>TFSAdminUtil ChangeAccount MyOldAcct MyNewAcct newPass

L'exemple suivant indique la syntaxe utilisée pour mettre à jour le mot de passe et le compte des comptes de service Reporting Services.

>TFSAdminUtil ChangeAccount /ra MyOldAcct MyNewAcct newPass

L'exemple suivant indique la syntaxe utilisée pour modifier le compte de service d'un compte de domaine, MyOldAccount, en Service réseau. Notez que pour un compte système, il n'y a pas de mot de passe.

>TFSAdminUtil ChangeAccount MyDomain\MyOldAccount "NT Authority\Network Service"

L'exemple suivant indique la syntaxe utilisée pour modifier le compte de messagerie en un_utilisateur@mondomaine.com lorsque vous modifiez le compte de service pour qu'il utilise le compte système Service réseau.

>TFSAdminUtil ChangeAccount MyDomain\MyOldAccount "NT Authority\Network Service" someuser@mydomain.com

Voir aussi

Tâches

Comment : modifier le compte de service ou le mot de passe pour SQL Server Reporting Services

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