共用方式為

針對連線至專案進行疑難排解 (機器翻譯)

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

如果您在 Azure DevOps 中遇到連接專案的問題，本文提供逐步故障排除指引，幫助您解決常見的連線與認證問題。

先決條件

類別 要求
專案存取 Project 成員。

快速解決步驟

如果你遇到連線問題，先試試以下幾個快速步驟：

  1. 完全清除瀏覽器：先用 https://aka.ms/VsSignout登出，然後清除所有 Cookie（按 Ctrl+Shift+刪除）。
  2. 使用私人瀏覽會話：開啟無痕模式或 InPrivate 視窗並測試存取。
  3. 確認組織網址：確保你使用的是正確的網址格式。 https://dev.azure.com/{organizationName}
  4. 檢查你的帳號類型：確認你使用的是正確的帳號類型（Microsoft Entra ID 與個人 Microsoft 帳號）。

如果這些步驟仍無法解決問題，請繼續進行以下詳細的故障排除步驟。

針對驗證錯誤進行疑難排解

Azure DevOps 支援 Microsoft Entra 帳號和 Microsoft 個人帳號進行認證。 連接 Microsoft Entra ID 的組織需要 Microsoft Entra 認證（會員或 B2B 訪客帳號）。

401 - 未授權錯誤

螢幕快照顯示 Azure DevOps 連線 401 錯誤。

401 未授權錯誤是最常見的登入問題。 此錯誤發生在您的身份沒有權限存取該組織或特定資源時。 常見的原因包括：

  • 身分未加入組織：你的帳號未登錄在組織的使用者目錄中。
  • 別名與 UPN 混淆：嘗試用別名登入，而非使用者主體名稱（UPN）。
  • 專案權限不足：目標專案或資源缺乏讀取權限。
  • 等待受理的 B2B 訪客邀請：Microsoft Entra B2B 訪客邀請尚未被接受。
  • 帳號類型不符：當多個帳號共用同一電子郵件地址時，嘗試用錯誤的帳號類型登入。

身份認同不在組織中

解決步驟：

  1. 請聯絡你的 Azure DevOps 管理員，確認你的身份是否出現在組織的 使用者 清單中。
  2. 對於 Microsoft Entra 帳號：確保使用者清單中的身份與你在 Microsoft Entra 租戶中的 UPN 完全一致。
  3. 針對 個人 Microsoft 帳號：確認身份是否與你的主要帳號電子郵件相符。
  4. 對於 B2B 訪客：確認你在訪客租戶的 UPN 與你家庭租戶的 UPN 完全一致，包括大小寫完全相符。

備註

B2B 訪客會出現在 Microsoft Entra ID 中，UPN 格式為 {username}_{homeDomain}#EXT#@{guestDomain}。 該{username}_{homeDomain}部分必須與您的租用戶UPN相符，並將_替換為@。

UPN 與別名登入問題

Azure DevOps 不支援登入別名。 Microsoft Entra 帳號必須使用你的精確使用者主體名稱（UPN），個人 Microsoft 帳號則必須使用主要帳號。

例： 如果你的 UPN 是 john.doe@contoso.com ，但你有別名 jdoe@contoso.com，你必須使用 john.doe@contoso.com。

主意： 請你的管理員將你的實際 UPNjohn.doe@contoso.com （） 加入組織，並且永遠使用這個 UPN 登入。

權限不足

你可能有組織權限，但缺乏特定專案或資源的權限。

徵兆：

  • 可以存取 https://dev.azure.com/{orgName} 但無法存取 https://dev.azure.com/{orgName}/{projectName}。
  • 存取特定工作項目、資料庫或管線時，會收到 401 錯誤。

主意： 聯絡你的 Azure DevOps 管理員，確認你至少有目標資源的 讀取 權限。

B2B 訪客邀請問題

B2B 訪客必須先接受 Microsoft Entra 租戶邀請，才能存取 Azure DevOps。

賓客的解決步驟：

  1. 請查看您的電子郵件以確認 Microsoft Entra 邀請。
  2. 請選擇邀請連結並完成接受流程。
  3. 嘗試再次登入 Azure DevOps。

租戶管理人的解決步驟：

  1. 移至 https://portal.azure.com。
  2. 選取 Microsoft Entra ID>使用者。
  3. 找到訪客使用者並查看他們的 概覽 頁面。
  4. 如果 B2B 邀請狀態顯示「待接受」，請使用重新發送邀請。

帳戶類型衝突

未與 Microsoft Entra ID 相關的組織，支援個人 Microsoft 帳號與 Microsoft Entra 帳號。 你使用的第一個帳號類型會永久建立你的身份。

主意： 如果你需要更改帳戶類型：

  1. 請你的管理員移除並重新加入組織。
  2. 提示時請以您偏好的帳號類型登入。

小提示

避免擁有相同的個人帳號和 Microsoft Entra 帳號。 建議考慮 更改個人帳號 名稱以避免混淆。

解決連接問題

完整的登出與清理：

  1. 完全登出：前往 https://aka.ms/VsSignout。
  2. 清除所有瀏覽器資料：選擇 Ctrl+Shift+刪除 並移除：
    • Cookies與網站資料。
    • 快取的影像和檔案。
    • 自動填入表單資料。
  3. 清除 Microsoft Edge 資料：Visual Studio IDE 使用 Microsoft Edge 的 Cookie，因此即使使用不同瀏覽器，也能清除 Microsoft Edge 的資料。
  4. 關閉所有應用程式：退出所有瀏覽器和 Visual Studio IDE 實例。
  5. 使用私人瀏覽測試：使用無痕或 InPrivate 視窗來測試存取。

Visual Studio IDE 連線問題

如果你在 Visual Studio 裡遇到連線問題：

  1. 移除現有連線：在 Team Explorer 中，移除所有 Azure DevOps 連線。
  2. 清除憑證快取：從 Windows 憑證管理器刪除快取的憑證。
  3. 重新啟動 Visual Studio：完全關閉並重新開啟 Visual Studio。
  4. 重新新增連線：使用目前的憑證重新新增你的 Azure DevOps 連線。

網路與代理問題

企業網路故障排除：

  1. 從不同網路測試：嘗試從個人裝置或網路存取 Azure DevOps。
  2. 檢查代理設定：確認企業代理伺服器允許 *.visualstudio.com 和 *.azure.com 網域。
  3. 防火牆設定：確保防火牆允許 HTTPS 流量傳送到 Azure DevOps 端點。
  4. VPN 干擾：如果適用，請關閉 VPN 進行測試。

進階疑難排解

現代認證遷移

如果你正在使用舊有的認證方法，建議考慮遷移到現代替代方案：

服務連線認證

針對 Azure DevOps 服務連線的認證問題，如果遇到問題，請遵循以下步驟：

  1. 刷新服務主體秘密：更新過期的用戶端秘密或憑證。
  2. 驗證權限：確保服務主體擁有適當的 Azure DevOps 權限。
  3. 檢查憑證過期：驗證認證憑證是否過期。
  4. 檢視稽核日誌：檢查 Microsoft Entra 稽核日誌是否有認證失敗。

用 AI 來排解連線問題

以下 Copilot 聊天的範例提示幫助 Copilot 排除連線與認證錯誤。 將此提示複製貼上到 Copilot Chat，並用你特定的錯誤訊息或問題描述取代佔位符。

I'm getting this Azure DevOps connection/authentication error: [PASTE YOUR ERROR MESSAGE HERE]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the connection problem
2. Fix the authentication or access issue
3. Verify I can successfully connect to my Azure DevOps project

Context: This is for connecting to an Azure DevOps organization and project. I've already tried basic troubleshooting like clearing browser cache and using a private browser session.

Copilot 是由 AI 所提供，因此可能會有驚喜和錯誤。 如需詳細資訊，請參閱 Copilot 一般使用常見問題。

尋求其他幫助

當你完成所有故障排除步驟卻仍無法連線時：

  1. 收集診斷資訊：建立你登入失敗嘗試的 瀏覽器追蹤 紀錄。
  2. 聯絡 Microsoft 支援： 建立支援請求 並包含：
    • 問題的詳細說明。
    • 這些步驟你已經嘗試過了。
    • 瀏覽器追蹤檔案。
    • 錯誤訊息的截圖。
  3. 社群支援：在 Azure DevOps 開發者社群搜尋或發問。

相關內容

  • Last updated on