Share via


プロジェクトへの接続のトラブルシューティング

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

接続のトラブルシューティング

接続の問題を解決するには、次の手順を実行します。

  1. ブラウザーからサインアウトします。 これを行うには、Visual Studio のサインアウト リンクを選択します。
  2. ブラウザーで Cookie を削除します。 ほとんどのブラウザーで Cookie を削除するには、Ctrl Shift Delete+キー+を押します。
  3. Microsoft Edge を開き、ブラウザーの Cookie を削除します。 Visual Studio IDE では、Microsoft Edge Cookie が使用されます。
  4. すべてのブラウザーを閉じて、Visual Studio IDE を閉じます。
  5. プライベート ブラウザー セッションを使用して、接続を再試行します。 Visual Studio IDE に問題がある場合は、接続を削除し、Team エクスプローラー で読み取った。

トラブルシューティングオプションの詳細については、この記事の「組織の切り替え」を参照してください

サインインのトラブルシューティング

サインインできる ID には、Microsoft アカウントと Microsoft Entra アカウントの 2 種類があります。 アカウントによっては、次のエラーが発生する場合があります。

401 - 許可されていません

Azure DevOps 接続 401 エラー 1 のトラブルシューティング

最も一般的なエラー ページは 、401 承認 されていないエラーです。これは、ID に組織へのアクセス許可がない場合に発生します。 一般的なエラーの理由を次に示します。

  • お使いの ID が組織のメンバーではありません。
  • ID に無効なライセンスまたは不足しているライセンスの割り当てがあります。
  • お使いの ID にリソースにアクセスできるだけのメンバーシップが割り当てられていません。 たとえば、閲覧者/共同作成者グループのメンバーシップです。
  • ID はテナント内の B2B ゲストであり、招待は受け入れられません。

組織のメンバーであると思うが、このエラー ページが表示される場合は、 サポートにお問い合わせください。

シナリオ 1

職場または学校の Microsoft Entra アカウントにはアクセス権はありませんが、個人の Microsoft アカウントにはアクセスできます。

401 - 職場または学校アカウント、または個人のアカウント

Azure DevOps 接続 401 エラー 2 のトラブルシューティング

非常に特殊な 401 エラー ケースです。 この場合、個人の Microsoft アカウントと、同じサインイン アドレスを持つ職場または学校アカウント (Microsoft Entra ID) の両方が存在します。 職場または学校アカウントでサインインしましたが、個人用アカウントは組織にアクセスできる ID です。

対応策

場合によっては、同じサインイン アドレスを持つ 2 つの ID がわからない場合があります。 Office 365 または Microsoft Entra ID に追加されたときに、管理者が職場または学校の Microsoft Entra アカウントを作成した可能性があります。

現在の職場または学校の Microsoft Entra アカウントからサインアウトするには、[個人用 MSA アカウントでサインイン] を選択し、個人用 Microsoft アカウントを使用してサインインします。 認証後、組織にアクセスできるはずです。

  • 組織にアクセスできない場合は、Microsoft Entra ID がまだ存在し、職場または学校アカウントが Microsoft Entra テナントにあることを確認してください。

ヒント

このプロンプトが表示されないようにするには、Microsoft アカウントの名前を変更します。 その後、サインイン アドレスを使用するのは、職場または学校アカウント、または Microsoft Entra アカウントの 1 つの ID のみです。

シナリオ 2

個人の Microsoft アカウントにはアクセス権はありませんが、Microsoft Entra アカウントにはアクセスできません。 このシナリオは、401 エラー ページの逆バージョンです。 この場合、個人用アカウント (Microsoft アカウント ID) は組織にアクセスできません。また、職場または学校アカウント (Microsoft Entra ID) にもアクセスできます。 シナリオ 1 と同じガイダンスを逆にして適用します。

401 - 職場または学校アカウント、または個人のアカウント

Azure DevOps 接続 401 エラー 3 のトラブルシューティング

対応策

元のサインイン ページにリダイレクトされたら、すべての Cookie をクリアしてから、もう一度サインインすることをお勧めします。 それでも問題が解決しない場合は、 サポートにお問い合わせください。

Azure DevOps Services に接続できない

問題 解決方法
アクティブなアカウントまたはライセンスがありません。 自分がアカウントのメンバーであり、アクティブで有効なライセンスを持っていることを管理者に確認します。 詳細については、「ユーザーにライセンスを割り当てる」を参照してください
Azure DevOps Services 組織は Microsoft Entra ID に接続されています。 Azure DevOps Services 組織が Microsoft 365 または Microsoft Azure サブスクリプションに関連付けられているディレクトリに接続されている場合、ディレクトリ内のメンバーのみがアカウントにアクセスできます。

ディレクトリ管理者に連絡して 、組織アカウントを作成してもらうか、外部メンバーとしてディレクトリにアカウントを追加してください。
異なる組織アカウントを切り替えることはできません。 Microsoft Azure portal から作成されたアカウントなど、異なるディレクトリに接続する複数の組織と連携している場合、サインアウト機能が期待どおりに機能しない可能性があります。 たとえば、異なる組織アカウントを切り替えて、ディレクトリ テナントにリンクされている複数のアカウントに接続することはできません。

この問題が発生すると、点滅する空白のサインイン ダイアログ ボックスが数回表示されます。 その後、ダイアログ ボックスに接続するか、新しい接続を追加した後、TF31002またはTF31003エラーが表示されます。

この問題を解決するには、最新 の Visual Studio 更新プログラム を適用します。

詳細については、「Visual Studio Codespace で異なる組織アカウントを切り替えることはできません」を参照してください
異なる資格情報を使用して、Visual Studio から Azure DevOps Services にサインインする必要があります。 「プロジェクトに接続する」、別の資格情報でサインインするを参照してください

Azure DevOps Server 接続のトラブルシューティング

最も頻繁に報告される接続の問題とその操作の一覧を次に示します。 示された順序でリストを完了します。

  1. 必要なアクセス許可があることを確認します。 受信したエラーが読み取り専用またはブロックされたアクションを示している場合は、データに対して操作するアクセス許可がない可能性があります。
  2. コンピューターがネットワークに接続されていること、およびネットワーク リソースにアクセスできることを確認します。
  3. Azure DevOps Server がオフラインでないことを確認します。 Azure DevOps Server 管理者に問い合わせてください。
  4. プロジェクトが Azure DevOps Server の別のプロジェクト コレクションに移動されたかどうかを確認します。 移動された場合は、新しいサーバー名への接続を作成する必要があります。

TF31002: 接続できません

1 台のコンピューターからこのエラーを受け取ったが、他のコンピューターから受け取っていない場合、または他のコンピューターがこのエラーを受け取っていないと判断した場合は、次の解決策をチェックします。

問題 解決方法
パスワードの有効期限が切れています。 ユーザー ID とパスワードが正しく入力されていること、およびパスワードの有効期限が切れていなかったことを確認します。
正しくないサーバー URL を入力しました。 サーバー名、ポート番号、プロトコル (http/https) を含むサーバー URL を正しく入力したことを確認します。 詳細については、「プロジェクトへの接続」を参照してください
構成が変更されました。 オンプレミスの Azure DevOps Server の構成が変更された場合は、新しい接続を作成する必要があります。 クライアント キャッシュをクリアする必要がある場合もあります。
リモートで作業し、Azure DevOps プロキシ サーバーに接続して、Azure DevOps Server バージョン 管理にファイルをチェックする必要があります。 Azure DevOps プロキシに接続するように Visual Studio を構成します
Visual Studio クライアント バージョンよりも新しいバージョンの Azure DevOps Server に接続しています。 Visual Studio または Team エクスプローラーのバージョンが Azure DevOps Server と互換性がない可能性があります。 1 つ以上の GDR パックをインストールすることが必要な場合があります。 詳細については、「要件と互換性」を参照してください
ファイアウォールが Azure DevOps サービスをブロックしています。 「プログラムが Windows ファイアウォール経由で通信できるようにする」を参照してください
Visual Studio でクエリを実行すると、Visual Studio の応答が停止します。 コンピューターがプロキシ サーバーをバイパスするように構成されている可能性があります。 コンピューターの BypassProxyOnLocal 設定の構成を確認します。 詳細については、「BypassProxyOnLocal 構成」を参照してください

複数のユーザーが Azure DevOps Server に接続できない

複数のコンピューターで問題が発生した場合は、管理者に問い合わせて、サーバーが稼働していて、ネットワーク上で使用できるかどうかを確認してください。

管理者は、アプリケーション層サーバーのイベント ログをチェックして、問題を特定しようとします。 また、次の表を使用して、サーバーが正しく構成されていないかどうかを判断することもできます。 この表では、発生する可能性が高い問題が最初に表示されます。 表示される順序で解決策を試してみると、問題をすばやく解決できる可能性が高くなります。

問題 解決方法
TFSService アカウントのパスワードの有効期限が切れているか、正しくありません。 Azure DevOps Server の多くのサービスは、サービス アカウントの有効期限が切れると実行を停止します。 詳細については、「Azure DevOps Server のサービス アカウントまたはパスワードを変更する」を参照してください
Azure DevOps Server のアプリケーション層サーバーは使用できません。 必要な各サービスが実行されているかどうかを確認します。 必要なサービスが実行されていない場合は、再起動する必要があります。 必要に応じて、自動的に開始するように設定します。 詳細については、「サービス、アプリケーション プール、Web サイトの停止と開始」を参照してください
ネットワークは使用できません。 ネットワークが動作しているかどうかを確認します。
Azure DevOps Server の Web サイト ID が正しく構成されていません。 Azure DevOps Server の Web サイトに対して行われるサーバー バインドの割り当てを確認または修正します。
Azure DevOps Server の Web サイトへのアクセスは制限されています。 IP アドレスと実行メイン名に基づく Web サイトに対して行われる制限を確認または修正します。
ファイアウォールまたはポートが正しく構成されていません。 Web サイトのポート バインド割り当てとファイアウォールのポート割り当てを確認または修正します。 まず、Azure DevOps Server の管理コンソールを開き、[アプリケーション層] ページを表示して、URL の割り当てを確認する必要があります。 必要に応じて、[URL の変更] を選択して Web サイトの URL を変更します。 次に、インターネット インフォメーション サービス (IIS) のポート割り当てと、ファイアウォール経由で許可されるポートを確認する必要があります。 詳細については、「サーバーの状態の確認と設定ポートの割り当ての確認または修正」を参照してください。
doメイン 間の信頼関係が正しく構成されていません。 ユーザーのグループが Azure DevOps Server にアクセスできない場合は、doメインs 間で信頼の問題が発生する可能性があります。
ユーザーが Visual Studio から異なるバージョンの Azure DevOps Server に接続すると、TF31002 エラーが発生する可能性があります。 このエラーは、あるバージョンの GUID が別のバージョンの Azure DevOps Server と同じであるために発生する可能性があります。 ローカル クライアント キャッシュは、両方のバージョンで同じ GUID ベースのローカル キャッシュをメインしようとするため、混乱します。

修正するには、TFSConfig ChangeServerID コマンドを実行します。 TFSConfig ChangeServerID コマンドを参照してください

組織の切り替え

Microsoft Entra ID にリンクされている 2 つ以上の組織を使用している場合、サインアウト機能が期待どおりに機能しない可能性があります。 たとえば、異なる組織を切り替えて、ディレクトリ テナントにリンクされている複数の組織に接続することはできません。

この問題が発生すると、空白の画面が数回点滅します。 次に、[Azure DevOps Server への接続] ダイアログ ボックスに接続するか、新しい接続を追加した後に、次のいずれかのエラー メッセージが表示されます。

TF31003: 必要な資格情報を入力していないか、ユーザー アカウントに Azure DevOps Server に接続するアクセス許可がありません

TF31002: この Azure DevOps Server に接続できません

この問題を解決するには、Visual Studio 2013.2 を適用するか、Visual Studio ダウンロード Web サイトから新しいバージョンをインストールします。

もう 1 つの解決策は、ブラウザーの Cookie を削除することです。 詳細については、サポート記事 「Visual Studio Codespaces で異なる組織を切り替えることはできません」を参照してください。

Secure Sockets レイヤーを使用して Azure DevOps Server に接続する

Secure Sockets Layer (SSL) が構成されている Azure DevOps Server インスタンスに接続する場合は、証明書をインストールしてクライアント キャッシュをクリアします。 詳細については、「 Azure DevOps Server の SECURE Sockets Layer (SSL) を使用した HTTPS の設定 - クライアント コンピューターの構成」を参照してください。

クライアント コンピューターのキャッシュをクリアする

プロジェクト コレクションを移動または分割するときなど、オンプレミスの Azure DevOps Server 構成が変更されたら、キャッシュをクリアします。

  1. キャッシュをクリアするユーザーの資格情報を使用して、Azure DevOps Server のクライアント コンピューターにサインインします。

  2. Visual Studio の開いているインスタンスをすべて閉じます。

  3. ブラウザーを開き、コンピューターが実行されているオペレーティング システムに応じて、次のいずれかのフォルダーに移動します。

    • Windows 10ドライブ:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\6.0\Cache

    • Windows 8ドライブ:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\4.0\Cache

    • Windows 7 または Windows Vistaドライブ:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\2.0\Cache

  4. キャッシュ ディレクトリの内容 (すべてのサブフォルダーを含む) を削除します。