零信任 評估疑難排解

調查 零信任 評估的連線失敗、略過的檢查、執行緩慢、相依性衝突和報告問題。 先從受影響的階段開始,然後如果針對特定症狀的檢查無法解決問題,再收集診斷資料。 保留 PowerShell 工作階段或可用的診斷資料,以供調查使用。

開始之前,請先收集您的評估結果、PowerShell 版本資訊、執行範圍和錯誤摘要。 請參閱 先修條件 以獲得所需資訊。

Prerequisites

  • 評估 PowerShell 會話(如果還有的話)或其產生的診斷資料。
  • 評估版本和 PowerShell 版本、所選的支柱和測試 ID、受影響的階段,以及錯誤摘要。

故障排除清單

在更改權限、相依性或逾時前,先找出失敗階段。

識別受影響的階段

找出哪個評估階段失敗,這樣你才能選擇相關的診斷。

  1. 檢視連線訊息及 每次執行的診斷檔案 ,以判斷問題是否發生於連線、匯出、資料庫建立、測試或報表處理期間。
  2. 記錄評估版本、PowerShell 版本、選取的支柱與測試 ID,以及已去識別化的錯誤摘要。
  3. 如果你可能會使用繼續功能,請保留已完成的匯出和資料庫。

請檢查存取權與覆蓋範圍

使用症狀表選擇下一個檢查項目。 成功連線到 Microsoft Graph,並不表示其他所有服務的連線也都已建立,而跳過檢查也不能作為設定安全的證據。

徵兆 要檢查的事項
Graph 授權同意或角色驗證失敗。 比較授權 Get-ZtGraphScope資料,啟用所需使用者角色或設定應用程式權限,然後重新連線。 新的套件可能需要額外的同意。
服務無法連線或測試被跳過。 請檢查服務的角色、授權、平台和連線訊息。 請參閱 連線指引。
保護、標籤、資料遺失防護(DLP)或搜捕檢查會回傳授權錯誤。 檢查該命令或 API 的工作負載角色指派和資料範圍,而不要只看 Microsoft Entra ID 角色名稱。 使用存取表。
基礎建設方面沒有任何發現項目。 確認 Azure 的讀取權限和訂閱標籤。 沒有已加上標籤或可存取的訂閱,不算通過評估。
執行時間過長、請求被限速或記憶體壓力增加。 檢查收集器和測試日誌。 在 組態設定中檢視回看、並行、快取和逾時。
憑證連線失敗。 檢查憑證有效性/私鑰、應用程式公鑰註冊、租戶 GUID、同意以及服務主體角色。 SharePoint 也需要在目前的連接器中有一個可匯出的金鑰。
受限語言模式會阻止執行。 使用經核准且支援評估的主機或原則。 不要繞過組織控制;進階覆寫並不會讓受限操作運作正常。

原因和解決方案

請使用以下程序處理相依性及報表錯誤。 在選擇變通方法前,請先檢查受影響的版本。

解決 Graph 組件衝突

對於 Could not load file or assembly Microsoft.Graph.Authentication,請從全新的處理程序開始,而不是移除共用模組。

  1. 開始一個新的 pwsh -NoProfile 行程。
  2. 讓評估先載入其釘選的依賴,然後再載入其他雲端模組。
  3. 如果問題依舊,請檢查 相依快取和清理主機指引 。

另一個已安裝的模組不一定是衝突,但已載入的組件可能會不相容。 移除或重新匯入模組,並無法穩定地卸載組件。 避免將共用 Graph 模組和第三方清理腳本一刀切移除作為預設的解決方法。

解決 DuckDB 初始化錯誤

錯誤 The type initializer for 'DuckDB.NET.Data.DuckDBConnectionStringBuilder' threw an exception 可能有不同的根本原因。

  1. 檢視內部例外。 在 Windows 上,DllNotFoundException 的 duckdb 可能表示缺少原生相依性。
  2. 若缺少,請安裝 Microsoft Visual C++ Redistributable(x64)。
  3. 在全新 PowerShell 工作階段中重試。 不要假設每個資料庫錯誤都有相同的原因。

從報表輸出錯誤中恢復

較舊的報告可能會顯示 Unexpected Application Error! Invalid array length。 相關報告包括 microsoft/zerotrustassessment#1235、microsoft/zerotrustassessment#1272、microsoft/zerotrustassessment#1310 及 microsoft/zerotrustassessment#1388。

  1. 請查看問題和你版本的發行歷程。 不要以為一定需要預先發行版。
  2. 如果匯出和資料庫建立完成,請保留它們。
  3. 安裝適用修正後,重新連線並使用 -Resume、原始路徑與 pillar 來重新執行評估和報告處理。
  4. 如果成功產生,請使用經典的 HTML 報告。

檢視評估活動

檢視 PowerShell 原始碼、進度儀表板及 每次執行日誌 ,以了解評估的活動狀況。 前述 進階故障排除指南 涵蓋支援套件分析。

進階疑難排解和資料收集

不同的診斷會捕捉不同的階段。 在收集或分享資料前,先選擇與故障地點相符的位置。

日誌與診斷檔案

<Path> 是你傳遞到 Invoke-ZtAssessment -Path的目錄,或 .\ZeroTrustReport 預設。 可選的支援套件、每次執行的檔案與擴充的 PSFramework 日誌是三個獨立的診斷位置。

地點 內容與用途
<Path>\log\ 由 -ExportLog 在接近成功完成時建立的 PSFramework 支援套件 ZIP,包含 .cliDat 快照。 如果交換器未被使用或運行在此階段前失敗,則可不存在。
<Path>\zt-export\logs\<run>\1-export_progress.log 匯出收集器的進展與狀態。 從這裡開始處理資料收集問題。
<Path>\zt-export\logs\<run>\2-database_progress.log 資料庫建置進度與時間。 繼續作業會跳過這個階段。
<Path>\zt-export\logs\<run>\3-test_progress.log 評估執行的進度與狀態。
<Path>\zt-export\logs\<run>\1-Export\export_<Name>.md 收集器狀態、持續時間、時間戳、端點/類型、模組版本及診斷訊息。
<Path>\zt-export\logs\<run>\2-Tests\<TestID>.md 測試標題、狀態、時長、時間戳、模組版本及詳細訊息,可能包含查詢文字。
%APPDATA%\PowerShell\PSFramework\Logs\在 Windows 上 擴充訊息日誌與 XML 錯誤記錄,獨立於輸出路徑。 對於連線/匯入問題、例外、來源位置、堆疊追蹤以及個別測試外的訊息非常有用。

<run> 使用時間戳記格式 yy-MM-dd-HHmmss。 檔案會在其各個階段執行時出現;部分執行或恢復執行不必包含所有檔案。 每次執行的檔案是獨立於 -ExportLog 產生的。

擴充的 PSFramework 檔案包含電腦/程序識別碼及編號區段,如 <computer>_<pid>_message_0.log 和 <computer>_<pid>_error_0.xml。 可用性與保留性取決於日誌提供者的設定。

在 Windows 上,%APPDATA%會識別使用者的漫遊資料夾,通常為%USERPROFILE%\AppData\Roaming。 在 PowerShell 中,使用 $env:APPDATA;其等效的日誌路徑為 Join-Path $env:APPDATA 'PowerShell\PSFramework\Logs'。

其餘 <Path>\zt-export 部分是評估資料,不只是日誌:匯出實體、 ztConfig.json、 db\zt.db、 ZeroTrustAssessmentReport.json、 ZeroTrustWorkshop.json。 這些檔案可以幫助重現或恢復執行,但也可能包含敏感的租戶資料。 刪除 <Path> 不會移除獨立的 PSFramework 日誌。

擷取支援套件

如果執行失敗,且未建立可選支援套件,請在同一 PowerShell 會話中擷取診斷資料,然後再關閉該 PowerShell。

  1. 請選擇診斷套件的獨立目的地。 它不需要和評估結果的路徑相符。 將範例目的地替換為此次執行所用的資料夾:

    New-PSFSupportPackage -Path C:\AssessmentLogs\Run01 -Force
    
  2. 解壓縮產生的 ZIP,即可存取其中的 .cliDat 檔案。

  3. 分享前請先審查並編修診斷資料。 關於匯入與調查快照,請參閱 進階日誌分析指南。

支援套件快照包含可用的工作階段診斷資訊,包括訊息與錯誤記錄,以及可能包含指令歷程記錄或主控台輸出。 它不是自動歸檔所有匯出租戶檔案的系統。

Warning

報告、匯出、支援套件及擴展日誌可包含個人資訊、租戶識別碼、查詢值及設定細節。 切勿未經審核地將這些內容附加到公開的 GitHub 議題上,或上傳到未經批准的工具。 僅透過與接收者約定的核准私人管道分享額外診斷資料。

回報問題或提供回饋

搜尋或提交 GitHub 議題,或使用回饋頻道。 包含評估版本、PowerShell 版本、選取的支柱與測試 ID、受影響階段,以及經過清理的錯誤摘要。

這項評估是社群專案,並非官方 Microsoft 產品。 社群問題通報並非支援合約或保證會有回應。 分享診斷前請先閱讀 支援政策 。