Freigeben über

Umbenennen eines Projekts in Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Durch das Umbenennen eines Projekts in Azure DevOps wird der Projektname in Versionskontrollpfaden, Arbeitselemente, Abfragen und anderen Projektartefakten aktualisiert. Sie können ein einzelnes Projekt mehrmals umbenennen und alte Namen verwenden. Einige Aktionen von Teammitgliedern erforderlich sein könnten nachdem Sie das Projekt umbenannt haben.

Warnung

  • Beim Umbenennen eines Projekts benachrichtigt Azure DevOps alle Projektmitglieder per E-Mail, wenn die Benutzeranzahl kleiner als 1.000 ist. Bei Projekten mit mehr als 1.000 Benutzern erhalten nur Projektsammlungsadministratoren diese Benachrichtigungen.

  • Die Umbenennung eines Projekts unterbricht die Subjekte des Identitätsverbunds in den Verbindungen der Azure Resource Manager-Dienste.

Voraussetzungen

Kategorie Anforderungen
Berechtigungen Mitglied der Gruppe Projektadministratoren, oder auf Projektebene ist die Berechtigung Teamprojekt umbenennen auf Zulassen festgelegt. Weitere Informationen finden Sie unter Ändern von Berechtigungen auf Projektebene.

Benennen Sie ein Projekt um

  1. Melden Sie sich bei Ihrem Projekt (https://dev.azure.com/{Your_Organization}/{Your_Project}).

  2. Wählen Sie Projekt-Einstellungen>Übersichtund geben Sie dann einen neuen Namen ein und wählen Sie speichern.

    Screenshot mit Eingabe eines neuen Namens und hervorgehobener Schaltfläche

  3. Um die Umbenennung zu bestätigen, geben Sie den neuen Projektnamen ein, markieren das Kästchen neben "Ich verstehe die Konsequenzen der Umbenennung dieses Projekts" und wählen dann speichern.

    Screenshot des Bildschirms zur Bestätigung des neuen Namens mit der Schaltfläche

Ergebnisse der Umbenennung

Nach dem Umbenennungsvorgang werden die folgenden Ergebnisse angezeigt.

  • Azure DevOps benennt das Projekt um.

  • Alle Projektmitglieder erhalten eine E-Mail-Benachrichtigung über die Namensänderung, wenn weniger als 1.000 Mitglieder vorhanden sind.

  • Die URL funktioniert weiterhin sowohl für den neuen als auch für den alten Teamnamen. Mit dieser Funktionalität sollen Verbindungsabbrüche vermieden werden.

  • Wenn das Projekt in der URL ein gültiges Projekt in der Organisation ist, zeigen wir die angegebene Workitem-ID an. Das folgende Beispiel zeigt eine Organisation mit Projekten namens "Beispiel1" und "Beispiel2".

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - Zeigt Workitem 40 an https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ - Zeigt Workitem 40 an https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - Zeigt einen 404-Fehler an

  • Die Workitem-IDs sind in der Organisation eindeutig und die Links laufen daher nicht ab.

  • Der alte Projektname kann wieder verwendet werden.

Erforderliche Benutzeraktionen für die Arbeit mit dem umbenannten Projekt

Jeder Benutzer innerhalb Ihres Mannschaften muss ihre Clients neu starten und einige der folgenden Aktionen durchführen, basierend auf den von ihnen verwendeten Funktionen:

Clients neu starten

Geöffnete Clients behalten einen Cache aller Projektnamen im Speicher, aber dieser Cache wird nicht automatisch geleert, wenn ein Projekt umbenannt wird. Um den Cache zu löschen, starten Sie Ihren Client neu, damit er den neuen Projektnamen einfügt. Wenn Sie den Client nicht neu starten, schlagen Operationen, die den gecachten Projektnamen verwenden, mit einer Projekt nicht gefunden Ausnahme.

Für die folgenden Clients speichern Sie Ihre Arbeit in jedem und starten dann neu:

Git Fernbedienungen aktualisieren

Wenn Ihr Projekt Git verwendet, müssen Ihre Remote-Referenzen für jedes Repository aus dem umbenannten Projekt aktualisiert werden. Diese Aktualisierungen sind erforderlich, da die URL des Remote-Repository das Projekt und den Repository-Namen enthält. Git verwendet Remote-Referenzen, um Änderungen zwischen Ihrem lokalen Repository und der auf dem Server gespeicherten Remote-Version abzurufen und zu übertragen. Jedes Teammitglied muss seine lokalen Git-Repositories aktualisieren, um die Verbindung von seinen Entwicklungscomputern aus fortzusetzen.

Für weitere Informationen siehe Aktualisieren Sie die Git-Remotes auf Ihren Entwicklungsrechnern.

Aktualisieren von TFVC-Server-Arbeitsbereichen

Wenn Ihr Projekt TFVC mit Server-Workspacesmüssen diese Arbeitsbereiche mit dem neuen Projektnamen aktualisiert werden. Für Visual Studio Clients führen Sie ein get oder einen Check-In aus und dann wird die Arbeitsbereichszuordnung korrigiert, um den neuen Projektnamen zu verwenden.

Screenshot des Explorers der Versionskontrolle, der die Auswahl der neuesten Version zeigt.

Für weitere Informationen siehe Befehl Umbenennen (TFVC).

TFVC lokale Arbeitsbereiche aktualisieren

Wenn Ihr Team TFVC mit lokale ArbeitsbereicheDiese Arbeitsbereiche müssen dann mit dem neuen Projektnamen aktualisiert werden. Führen Sie in Visual Studio ein Get oder Check-in aus, und die Arbeitsbereichszuordnung wird korrigiert, um den neuen Projektnamen zu verwenden.

Wir empfehlen Ihnen, Ihre Clients nach Möglichkeit auf das neueste Aktualisieren oder Release zu aktualisieren. Für alle anderen unterstützten Visual Studio-Versionen müssen Sie einen neuen lokalen Arbeitsbereich erstellen, der dem neuen Projektnamen zugeordnet ist.

Lokale Workspaces werden lokal und nicht auf dem Server verwaltet. Ältere Clients ohne die aktualisierte Umbenennungslogik können die lokalen Arbeitsbereiche nicht auf den neuen Projektnamen aktualisieren.

Aktualisieren von OData-Feeds

Wenn Sie OData-Feeds in Power BI verwenden, aktualisieren Sie die Feed-URL so, dass der neue Projektname verwendet wird. Das Aktualisieren der Feed-URL ist unerlässlich, um Datenverbindungen aufrechtzuerhalten und Fehler bei der Berichterstellung zu vermeiden. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

Aktualisieren von Analyseansichten

Wenn Sie benutzerdefinierte Analyseansichten mit dem alten Projektnamen erstellt haben, müssen Sie die Ansichten mit dem neuen Namen aktualisieren. Weitere Informationen finden Sie unter Analyseansichten.

Verwandte Inhalte

Häufig gestellte Fragen (FAQs)

F: Warum ist mein Versuch, einen Projektnamen wiederzuverwenden, an bestehenden Arbeitsbereichen gescheitert?

A: Sie können einen Projektnamen nicht wiederverwenden, wenn es noch Arbeitsbereich-Zuordnungen gibt, die ihn adressieren. Diese Funktion hilft, den Fall zu vermeiden, dass ein Arbeitsbereich zwei Projekten zugeordnet werden kann. Wenden Sie sich an die Benutzer, die über diese Zuordnungen verfügen, und löschen Sie sie, oder aktualisieren Sie sie), um den neuen Namen zu verwenden.

Wenn der Rechner des Benutzers, auf dem sich der Arbeitsbereich befindet, nicht mehr verfügbar ist, können Sie den Arbeitsbereich löschen, indem Sie den folgenden Befehl in der Entwickler-Eingabeaufforderung von Visual Studio ausführen: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

F: Wie wirkt sich das Umbenennen eines Projekts auf die Browser-Navigation aus?

A: Nachdem Sie ein Projekt umbenannt haben, können in allen Browsern, in denen das Projekt geöffnet ist, einige Fehler auftreten. Diese Fehler sind auf den Zwischenspeicher des Browsers zurückzuführen, der den alten Projektnamen enthält. Aktualisieren Sie, um diese Fehler zu beheben, da der Cache mit dem neuen Projektnamen neu befüllt wird.

F: Werden andere Artefakte im Projekt umbenannt?

A: Ja, alle Artefakte, die denselben Namen haben, werden zusammen mit dem Projekt umbenannt. Die einzigen Ausnahmen sind das Standardteam und das Projektarchiv. Die Umbenennung dieser Artefakte wird nach bestem Wissen und Gewissen durchgeführt. Zum Beispiel, wenn ein Projekt Foo wurde umbenannt in Bardas Standardteam Foo würde nicht umbenannt werden, wenn ein Team mit dem Namen Bar existierten bereits im Projekt.

F: Warum kann ich Abfragen, die nach einer Umbenennung auf einem Datenträger gespeichert wurden, nicht öffnen?

A: Wenn Sie Visual Studio 2010 verwenden und Abfragen auf einem Datenträger gespeichert haben, können Sie diese nach dem Umbenennen eines Projekts nicht mehr öffnen. Sie können Visual Studio 2012 oder eine neuere Version verwenden, um sie zu öffnen.