Azure DevOps でプロジェクト名を変更する

Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019

Azure DevOps でプロジェクトの名前を変更すると、バージョン 管理パス、作業項目、クエリ、およびその他のプロジェクト成果物のプロジェクト名が更新されます。 1 つのプロジェクトの名前を複数回変更でき、以前の名前も使用できます。 プロジェクトの名前を変更した後で、チーム メンバーによるアクションがいくつか必要になる場合があります。

前提条件

プロジェクトの名前変更

1. プロジェクトにサインインします(https://dev.azure.com/{Your_Organization}/{Your_Project})。

2. [プロジェクトの設定]>[概要]を選択し、新しい名前を入力して [保存] を選択します。

   

3. 名前の変更を確認するには、新しいプロジェクト名を入力し、[私は、このプロジェクトを名前変更した場合の影響を理解しています] の横にあるチェック ボックスをオンにして、[保存] を選択します。

   

名前変更の結果

名前の変更操作の後に、次の結果が起こります。

• Azure DevOps によってプロジェクト名が変更されます。

• メンバーが 1,000 人未満の場合、すべてのプロジェクト メンバーは名前の変更に関するメール通知を受け取ります。

• URL は、新しいチーム名と古いチーム名の両方で引き続き機能します。 この機能は、リンク切れを回避することを目的としています。

• URL 内のプロジェクトが組織内の有効なプロジェクトである場合は、指定された作業項目 ID が表示されます。 次の例は、"Example1" と "Example2" という名前のプロジェクトがある組織を示しています。

  https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - 作業項目 40 が表示されます https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ - 作業項目 40 が表示されます https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - 404 エラーが表示されます

• 作業項目 ID は組織内で一意であるため、リンクは期限切れになりません。

• 古いプロジェクト名は再利用できます。

名前が変更されたプロジェクトを操作するために必要なユーザー アクション

チーム内の各ユーザーはクライアントを再起動し、使用する機能に基づいて次のアクションを実行する必要があります。

• Git リモートを更新する
• Team Foundation バージョン管理 (TFVC) サーバー ワークスペースを更新する
• TFVC ローカル ワークスペースを更新する
• OData フィードを更新する
• Analytics ビューを更新する

クライアントを再起動する

開いているクライアントは、すべてのプロジェクト名のキャッシュをメモリ内に保持しますが、プロジェクト名が変更された後、このキャッシュは自動的にクリアされません。 キャッシュをクリアするには、新しいプロジェクト名が反映されるようにクライアントを再起動します。 クライアントを再起動しないと、キャッシュされたプロジェクト名を使用する操作が失敗し、プロジェクトが見つからないという例外が発生します。

次のクライアントの場合は、それぞれの作業内容を保存し、再起動します。

• Visual Studio チーム エクスプローラー
• Microsoft Excel (チームが Azure DevOps Office Integration 2019 を使用している場合)

Git リモートを更新する

プロジェクトで Git を使用する場合は、名前が変更されたプロジェクトの各リポジトリのリモート参照を更新する必要があります。 これらの更新は、リモート リポジトリ URL にプロジェクトとリポジトリ名が含まれているために必要です。 Git はリモート参照を使用し、ローカル リポジトリとサーバー上に保存されているリモート バージョン間の変更をフェッチおよびプッシュします。 チームの各メンバーは、開発マシンからの接続を継続するために、ローカル Git リポジトリを更新する必要があります。

詳細については、「開発マシンで Git リモートを更新する」を参照してください。

TFVC サーバー ワークスペースを更新する

プロジェクトで TFVC とサーバー ワークスペースを使用している場合は、これらのワークスペースを新しいプロジェクト名で更新する必要があります。 Visual Studio クライアントの場合は、取得またはチェックインを実行します。すると、新しいプロジェクト名を使用するようにワークスペースのマッピングが修正されます。

詳細については、名前の変更コマンド (TFVC) に関するページを参照してください。

TFVC ローカル ワークスペースを更新する

チームがローカル ワークスペースで TFVC を使用している場合は、これらのワークスペースを新しいプロジェクト名で更新する必要があります。 Visual Studio の場合は、get または check-in を実行します。新しいプロジェクト名を使用するようにワークスペースのマッピングが修正されます。

可能であれば、クライアントを最新の更新プログラムまたはリリースに更新することをお勧めします。 サポートされている他のすべての Visual Studio バージョンでは、新しいプロジェクト名にマップされた新しいローカル ワークスペースを作成する必要があります。

ローカル ワークスペースは、サーバー上ではなくローカルで管理されます。 更新された名前変更ロジックがない古いクライアントの場合、ローカル ワークスペースを新しいプロジェクト名に更新できません。

OData フィードを更新する

Power BI で OData フィードを使用する場合は、新しいプロジェクト名を使用するようにフィード URL を更新します。 フィード URL の更新は、データ接続を維持し、レポートのエラーを回避するために不可欠です。 詳細については、「 OData クエリを使用したサンプル レポートの概要を参照してください。

Analytics ビューを更新する

古いプロジェクト名を使用してカスタム分析ビューを作成した場合は、新しい名前でビューを更新する必要があります。 詳細については、「 分析ビュー」を参照してください。

関連コンテンツ

• プロジェクトを削除する
• Git と Azure Repos

よく寄せられる質問 (FAQ)

Q: プロジェクト名を再利用しようとして、既存のワーク スペースが原因で失敗したのはなぜですか?

A: プロジェクト名に対応するワークスペースのマッピングがまだ存在する場合、プロジェクト名は再利用できません。 この機能は、1 つのワークスペースが 2 つのプロジェクトにマッピングされるというあいまいなケースを回避するのに役立ちます。 新しい名前を使用するために、これらのマッピングを持つユーザーに連絡し、それらを削除するか更新します。

ワークスペースを含むユーザーのマシンが使用できなくなった場合は、Visual Studio の開発者コマンド プロンプトから次のコマンドを実行して、ワークスペースを削除できます: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

Q: プロジェクトの名前を変更すると、ブラウザーのナビゲーション エクスペリエンスにどのような影響がありますか?

A: プロジェクトの名前を変更すると、プロジェクトを開いたブラウザーでエラーが発生する可能性があります。 これらのエラーは、ブラウザーに保持されているキャッシュに古いプロジェクト名が含まれていることが原因です。 ページを更新すると、キャッシュが新しいプロジェクト名で再構成されるため、これらのエラーは解消されます。

Q: プロジェクト内の他の成果物の名前は変更されますか?

A: はい。同じ名前を共有するすべての成果物は、プロジェクトと共に名前が変更されます。 唯一の例外は、既定のチームとリポジトリに関するものです。 これらの成果物の名前の変更は、ベスト エフォートで実行されます。 たとえば、プロジェクト Foo の名前が Bar に変更された場合、プロジェクトに Bar という名前のチームが既に存在する場合、既定のチーム Foo の名前は変更されません。

Q: 名前を変更した後にディスクに保存されたクエリを開くことができないのはなぜですか?

A: Visual Studio 2010 を使用していて、クエリをディスクに保存している場合、プロジェクトの名前を変更した後で開くことはできません。 Visual Studio 2012 以降であれば、開くことができます。