プロジェクトへの接続のトラブルシューティング
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
接続のトラブルシューティング
接続の問題を解決するには、次の手順を実行します。
- ブラウザーからサインアウトします。 これを行うには、 Visual Studio のサインアウト リンクを選択します。
- ブラウザーで Cookie を削除します。 ほとんどのブラウザーで Cookie を削除するには、 Ctrl+Shift+Delete を選択します。
- Microsoft Edge を開き、ブラウザーの Cookie を削除します。 Visual Studio IDE では、Microsoft Edge Cookie が使用されます。
- すべてのブラウザーを閉じて、Visual Studio IDE を閉じます。
- プライベート ブラウザー セッションを使用して、接続を再試行します。 Visual Studio IDE に問題がある場合は、接続を削除し、チーム エクスプローラーで読み取った。
その他のトラブルシューティング オプションについては、この記事の Switch 組織を参照してください。
サインインのトラブルシューティング
サインインできる ID には、Microsoft アカウントと Microsoft Entra アカウントの 2 種類があります。 アカウントによっては、次のエラーが発生する場合があります。
401 - 許可されていません
最も一般的なエラー ページは 401 Not Authorized エラーです。これは、ID に組織へのアクセス許可がない場合に発生します。 一般的なエラーの理由を次に示します。
- お使いの ID が組織のメンバーではありません。
- ID に無効なライセンスまたは不足しているライセンスの割り当てがあります。
- お使いの ID にリソースにアクセスできるだけのメンバーシップが割り当てられていません。 たとえば、閲覧者/共同作成者グループのメンバーシップです。
- ID はテナント内の B2B ゲストであり、招待は受け入れられません。
組織のメンバーであると思うが、このエラー ページが表示される場合は、サポート。
シナリオ 1
職場または学校の Microsoft Entra アカウントにはアクセス権はありませんが、個人の Microsoft アカウントにはアクセスできます。
401 - 職場または学校アカウント、または個人のアカウント
非常に特殊な 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 - 職場または学校アカウント、または個人のアカウント
対応策
元のサインイン ページにリダイレクトされたら、すべての 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 接続のトラブルシューティング
最も頻繁に報告される接続の問題とその操作の一覧を次に示します。 示された順序でリストを完了します。
- 必要なアクセス許可があることを確認します。 受信したエラーが読み取り専用またはブロックされたアクションを示している場合は、データに対して操作するアクセス許可がない可能性があります。
- コンピューターがネットワークに接続されていること、およびネットワーク リソースにアクセスできることを確認します。
- Azure DevOps Server がオフラインでないことを確認します。 Azure DevOps Server 管理者に問い合わせてください。
- プロジェクトが Azure DevOps Server の別のプロジェクト コレクションに移動されたかどうかを確認します。 移動された場合は、新しいサーバー名への接続を作成する必要があります。
- サポートされているバージョンの 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 またはチーム エクスプローラーのバージョンが Azure DevOps Server と互換性がない可能性があります。 1 つ以上の一般配布リリース (GDR) パックのインストールが必要になる場合があります。 詳細については、「 Requirements と互換性を参照してください。 |
| ファイアウォールが 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 の割り当てを確認する必要があります。 必要に応じて Change URL を選択して、Web サイトの URL を変更します。 次に、インターネット インフォメーション サービス (IIS) のポート割り当てと、ファイアウォール経由で許可されるポートを確認する必要があります。 詳細については、「 Review サーバーの状態と設定 および 検証または正しいポート割り当てを参照してください。 |
| ドメイン間の信頼関係が正しく構成されていません。 | ユーザーのグループが Azure DevOps Server にアクセスできない場合は、ドメイン間で信頼の問題が発生する可能性があります。 |
| ユーザーが Visual Studio から異なるバージョンの Azure DevOps Server に接続すると、TF31002 エラーが発生する可能性があります。 | このエラーは、あるバージョンの GUID が別のバージョンの Azure DevOps Server と同じであるために発生する可能性があります。 ローカル クライアント キャッシュは、両方のバージョンで同じ GUID ベースのローカル キャッシュを維持しようとするため、混乱します。 修正するには、 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 構成が変更されたら、キャッシュをクリアします。
キャッシュをクリアするユーザーの資格情報を使用して、Azure DevOps Server のクライアント コンピューターにサインインします。
Visual Studio の開いているインスタンスをすべて閉じます。
ブラウザーを開き、コンピューターが実行されているオペレーティング システムに応じて、次のいずれかのフォルダーに移動します。
Windows 10Drive:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\6.0\Cache
Windows 8Drive:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\4.0\Cache
Windows 7 または Windows VistaDrive:\Users<i>UserName\AppData\Local\Microsoft\Team Foundation\2.0\Cache
キャッシュ ディレクトリの内容 (すべてのサブフォルダーを含む) を削除します。