Note
dotnetup 目前處於公開預覽階段。 其特性與行為可能會在正式上市前改變。
dotnetup包含遙測功能，能收集使用資料並在執行dotnetup指令時傳送給 Microsoft。 使用資料中包含當機時 dotnetup 的例外資訊。 .NET 團隊利用這些數據了解人們如何使用工具並解決問題。
如何退出
遙測預設為開啟。 若要停用，請將 DOTNET_CLI_TELEMETRY_OPTOUT 環境變數設為 1 或 true。
這也是關閉 .NET SDK 和 CLI 遙測功能的變數。 欲了解更多資訊，請參閱 .NET SDK 與 .NET CLI 遙測。
首次運行通知
第一次執行 dotnetup時，會顯示以下訊息：
dotnetup collects usage data to help improve your experience. You can opt out by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1'. Learn more: https://aka.ms/dotnetup-telemetry
若想隱藏此通知而不關閉遙測，請將 DOTNET_NOLOGO 環境變數設為 1 或 true。
數據點
遙測功能不會收集個人資料，例如用戶名稱或電子郵件位址。 它不會掃描你的程式碼，也不會擷取專案層級的資料。
dotnetup透過 Azure 監視器 技術安全地將資料傳送至 Microsoft 伺服器。
dotnetup 收集以下資料：
- 叫用的時間戳記。
- 你執行的指令，例如
install、update或list。 - 版本
dotnetup與提交 SHA。 - 作業系統與架構。
- 是否
dotnetup運行於持續整合（CI）環境中。 -
dotnetup是否由 LLM 代理執行，例如 GitHub Copilot。 - 退出代碼，或成功或失敗狀態。
- 對於失敗事件：錯誤類型、錯誤類別、無檔案路徑的消毒錯誤細節，以及無例外訊息的堆疊追蹤。
當機例外狀況遙測
如果 dotnetup 當機，它會收集例外名稱和 dotnetup 程式碼的堆疊追蹤。 它不包含例外訊息，因為例外訊息可以包含使用者輸入。 這種方法與 .NET SDK 所採用的方法相同。 如需詳細資訊，請參閱 當機例外狀況遙測。
CI 與 LLM 代理偵測
dotnetup 使用與 .NET SDK 相同的 CI 環境偵測與 LLM 代理偵測。 關於它檢查的環境變數列表，請參見 持續整合偵測 與 大型語言模型偵測。
相關環境變數
| Variable | 描述 |
|---|---|
DOTNET_CLI_TELEMETRY_OPTOUT |
設定為 1 或 true時會關閉遙測。 |
DOTNET_NOLOGO |
設定為 1 或 true時，會隱藏首次執行通知。 遙測維持啟用。 |
DOTNET_CLI_TELEMETRY_STORAGE_PATH |
在上傳資料前，先更改 dotnetup 在本地儲存遙測資料的目錄。 |
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS |
在 CI 環境中，會變更 dotnetup 在結束前等待傳送遙測資料的最長時間（以毫秒為單位）。 預設是20,000。 |
隱私權
如果你認為遙測收集了敏感資料，或 Microsoft 對資料的處理不安全或不當，請向 dotnet/SDK 儲存庫提出問題。
如需詳細資訊，請參閱Microsoft隱私聲明。
