次の方法で共有

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

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

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

警告

  • プロジェクトの名前を変更すると、Azure DevOpsは、ユーザー数が 1,000 未満の場合、すべてのプロジェクト メンバーに電子メールで通知します。 ユーザー数が 1,000 人を超えるプロジェクトの場合、これらの通知を受け取るのはプロジェクト コレクション管理者だけです。

  • プロジェクトの名前を変更すると、Azure Resource Manager サービス接続のワークロード ID フェデレーションサブジェクトが中断されます。

ヒント

この記事の後半でAIを使用してこのタスクを支援することができます。また、作業を開始するには、Azure DevOps MCP ServerでAIサポートを有効にする方法を参照してください。

前提条件

カテゴリ 必要条件
Permissions プロジェクト管理者グループのメンバーまたはプロジェクト レベルの [チーム プロジェクトの名前の変更] アクセス許可が [許可] に設定されている。 詳細については、 プロジェクトレベルのアクセス許可の変更に関する記事を参照してください。

プロジェクトの名前変更

  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 は組織内で一意であるため、リンクは期限切れになりません。

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

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

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

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

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

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

  • 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 ビューを更新する

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

AI を使用してプロジェクトの名前変更を管理する

ヒント

この記事の後半でAIを使用してこのタスクを支援することができます。また、作業を開始するには、Azure DevOps MCP ServerでAIサポートを有効にする方法を参照してください。

GitHub Copilotを使用する場合、Azure DevOps MCP Server は、プロジェクト名の変更を計画および実行し、自然言語プロンプトを使用してすべてのフォローアップ アクションを処理するのに役立ちます。

プロジェクトの名前を変更するためのプロンプトの例

Task プロンプトの例
影響分析を使用して名前の変更を計画する I need to rename my Azure DevOps project from 'ProjectAlpha' to 'Platform-Core'. List everything that will break, including Git remotes, TFVC workspaces, OData feeds, and service connections, and give me a step-by-step remediation plan
チームに名前変更を伝える Draft an announcement for my team explaining that our Azure DevOps project is being renamed, what actions each developer needs to take to update their Git remotes and local workspaces, and a timeline for the change
サービス接続の切断を修正する After renaming my project, my Azure Resource Manager service connections using workload identity federation stopped working. Walk me through updating the federation subjects to use the new project name
Git リモートを一括で更新する Generate a script I can share with my team that detects their current Git remote URLs pointing to the old project name and updates them to use the new project name
名前の変更後にレポートを更新する I renamed my project and now my Power BI dashboards connected via OData show errors. Guide me through updating the Analytics views and OData feed URLs to use the new project name
問題のある名前変更から回復する I renamed a project but some team members can't open their TFVC local workspaces anymore. Help me understand why and walk me through the steps to fix both server and local workspaces

ヒント

最適な結果を得るには、Azure DevOps MCP サーバーが接続されているエージェント モードでこれらのプロンプトを使用します。 特定のプロジェクト名、チーム サイズ、またはバージョン管理システムを使用してプロンプトをカスタマイズします。

関連コンテンツ

よく寄せられる質問 (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 以降を使用して開くことができます。

  • Last updated on