Microsoft Defender 部署工具是一款輕量且可自行更新的應用程式,可安裝必要條件,並將 受支援的 Windows 裝置 上線至 適用於端點的 Microsoft Defender。 可在個別裝置上互動式執行此工具,或透過命令列參數、設定檔、群組原則、Microsoft Configuration Manager 或其他軟體部署系統自動化。
使用部署工具作為獨立的入職方式。 它不會與透過 Microsoft Intune、適用於雲端的 Microsoft Defender 或其他部署方法進行的上線流程整合。 開始前,先檢視 支援的作業系統 和 前置條件。
部署工具提供以下功能:
- 先決條件處理:檢查所需更新並解決阻礙部署的問題。
- 日誌與回饋:在本地日誌中記錄操作,並在互動模式下顯示錯誤描述。
- 安裝與更新:避免重新安裝現有元件,並在需要時下載目前版本的元件。
- 自動化:支援命令列參數及可重複使用的設定檔,以實現自動化部署。
- 預先下載:下載供無法直接下載檔案的目標裝置使用的安裝檔案。
- 伺服器被動模式:將 Microsoft Defender 防毒軟體配置為在 Windows Server 上以被動模式運行。
- 非持久虛擬桌面基礎架構(VDI):幫助以相同主機名稱重建的裝置在 Defender 入口網站中顯示為同一裝置。
- 套件護欄:需使用入口網站產生的存取金鑰進行上線,並支援套件有效期從一天到一年不等。 請使用最短的實際有效期。
- 嵌入式解除上線(預覽):將解除上線套件內建於工具中,並由入口網站產生的解除上線金鑰和自訂到期日保護,因此你不需要另外的解除上線檔案。
- 套件管理:在 Microsoft Defender 入口網站中列出部署套件,並可依狀態與到期日等屬性篩選。
-
內建說明:當你執行
DefenderDT.exe -?時,會顯示可用的命令列選項。
在互動模式下,工具會從 Defender 入口網站索取存取金鑰,安裝所需的更新與 Defender 元件,並將裝置連接到 Defender for Endpoint。 如果安裝需要重新啟動,請在重新啟動後登入,讓工具能繼續使用。
對於 進階及大規模部署,請使用命令列參數或設定檔。
支援的作業系統
Defender 部署工具支援以下作業系統:
- Windows 11
- Windows 10,版本 1809(2018 年 11 月)或更新版本
- Windows 7 SP1
- Windows Server 2016 或更新版本
- Windows Server 2012 R2
- Windows Server 2008 R2 SP1
注意事項
Defender for Endpoint 支援 Windows 8.1 Pro 與 Enterprise 版本,但 Defender 部署工具不支援。 使用 Microsoft 監控代理程式(MMA)將 Windows 8.1 裝置納入系統。 欲了解更多資訊,請參閱 將舊版 Windows 上線。
必要條件
在部署工具前,請先檢視 Windows 7 SP1 及 Windows Server 2008 R2 SP1 的一般前提與需求。
一般必要條件
大多數營運商需具備行政權限。
允許存取
definitionupdates.microsoft.com。 該工具會從該網域下載更新與安裝檔案。 由於檔案託管於內容分發網路,相關的 IP 位址範圍並非固定或可預測。Defender 部署工具明確要求其線上連線(包括自我更新、下載、遙測及上線 blob 驗證)使用 TLS 1.2。
如果您使用代理伺服器進行上線或離線,Defender 部署工具在離線時必須透過
-proxy設定代理。 此工具不會為自身連線沿用列出的 Defender 專屬登錄代理設定。該工具會在入職前檢查與組織的連結性。 其他 Defender for Endpoint 功能也需要存取服務 URL,例如
*.endpoint.security.microsoft.com。 完整需求請參閱「配置您的網路環境以確保與 Defender for Endpoint 服務的連結」。
為確保連線順暢,請將前往 *.endpoint.security.microsoft.com 的流量排除在 SSL/TLS 檢查、HTTPS 攔截和中間人(MITM)代理之外。 若啟用 SSL 檢查,Defender for Endpoint 感測器可能無法與後端服務通訊,導致上線或連線故障。
Windows 7 SP1 與 Windows Server 2008 R2 SP1 的前置條件
裝置必須執行 x64 版本的 Windows 7 SP1 或 Windows Server 2008 R2 SP1。 安裝最新的可用更新,以縮短安裝時間並降低重啟的可能性。
安裝 SHA-2 程式碼簽章支援。 部署工具至少需要KB4474419。
在 Windows Server 2008 R2 SP1 上,安裝 .NET Framework 3.5 或更新版本。
注意事項
如需更多有關適用於 Windows 7 SP1 和 Windows Server 2008 R2 SP1 的 Defender 端點安全性的資訊,請參閱「針對 Windows 7 SP1 和 Windows Server 2008 R2 SP1 裝置部署 Defender 端點安全性解決方案」。
產生並下載新的入門套件
在 Microsoft Defender 入口網站產生入職套件與存取鑰匙。 你需要在互動式或參數 -Key 下執行工具時使用存取金鑰。
在 Microsoft Defender 入口網站https://security.microsoft.com/securitysettings/endpoints/onboarding的入職頁面,請設定以下設定:
- 步驟 1:選擇作業系統開始部署:選擇 Windows。
- 步驟 2:選擇部署選項:在 透過下載並套用套件或檔案> 中選取 Onboard。
在開啟的使用存取金鑰產生 Defender 部署工具彈出式面板上,設定套件:
- 名稱:輸入一個獨特且具描述性的套件名稱。
- 組織:確認顯示的組織。
-
有效期限:使用最短的有效期限以降低未經授權的套件使用風險:
- 7天內 (預設)
- 30天後
- 客製化 (最長一年)
選擇 產生。
當套件準備好時,複製並安全儲存存取金鑰。
選擇 下載部署工具,並儲存已下載的執行檔。
在裝置上部署 Defender 端點安全
可互動或非互動方式執行 Defender 部署工具。
互動式使用
可對一台或少數裝置使用互動模式。 雙擊執行檔即可使用預設的入門設定,或從命令提示字元執行工具來指定選項。
若要使用預設設定上線裝置:
雙擊執行檔即可啟動。
在確認新人入職將開始的對話框中,選擇 繼續。
輸入你從入口網站複製的 Defender 部署工具金鑰,然後選擇 繼續。
等安裝完成後,再選擇 確定。 如果工具需要重新啟動,請在重新啟動後登入,以便繼續安裝。
非互動式使用
使用命令列介面來自動化安裝與啟動,或執行其他操作,例如前置檢查。
有關可用參數,請參閱 Defender 部署工具指令參考。 要查看你下載的工具版本的指令參考,請執行 DefenderDT.exe -?。
進階與大規模部署
請從群組政策、Microsoft Configuration Manager 或其他軟體部署系統中非互動式執行 Defender 部署工具。 使用命令列參數自訂初始設定、預備環境、更新、重新啟動、Proxy 設定及其他操作。
對於定期部署,請使用設定檔取代重複命令列參數。 使用 -MakeConfig 執行工具以產生 DefenderDTconfig.txt。 編輯設定,然後載入 -Config:<path>。 如果你沒指定路徑,工具會在目前資料夾中尋找路徑 DefenderDTconfig.txt 。 舉例說明,請參見 使用設定檔。
Defender 部署工具指令參考
下表列出 Defender 部署工具版本 1.0.0.6(2026 年 9 月)中可用的參數。 執行 DefenderDT.exe -? 以確認您下載版本中可用的參數。
| 類別 | 參數 | 描述 |
|---|---|---|
| 一般 |
-?,-Help |
顯示可用的選項。 |
| 一般 | -Quiet |
阻止對話出現。 |
| 一般 | -Verbose |
展示詳細資訊並撰寫詳細日誌。 |
| Configuration | -AllowReboot |
需要時讓裝置重新啟動。 |
| Configuration | -NoResumeAfterReboot |
請阻止工具在重新啟動後繼續運作。 |
| Configuration | -Proxy:<https://host:port> |
設定用於上線和 Defender for Endpoint 的代理伺服器。 在導入過程中,工具始終將 HKLM\SOFTWARE\Policies\Microsoft\Windows\DataCollection\DisableEnterpriseAuthProxy 設為 1。 當提供 -Proxy 旗標時,僅在缺少這些值時才會設定;不會覆寫現有的值:將同一機碼下的 TelemetryProxyServer 設為 host:port,以及將 HKLM\SOFTWARE\Policies\Microsoft\Windows Defender\ProxyServer 設為所提供的代理 URL。 |
| Configuration | -Precheck |
檢查先修條件並記錄結果,無需安裝或啟用即可。 |
| Configuration | -UpdateOnly |
即使存在上線檔案,仍可在未上線的情況下安裝更新。 |
| 入職培訓 | -File:<path> |
指定 .offboarding 或 .onboarding 檔案的絕對路徑。 如果你沒指定參數,工具會在目前資料夾中尋找 。WindowsDefenderATP.onboarding |
| 入職培訓 | -Source:<path> |
指定包含分階段安裝檔案的資料夾。 |
| 入職培訓 | -Passive |
將 Microsoft Defender Antivirus 設定為以被動模式執行。 |
| 入職培訓 | -VDI |
將該裝置識別為非持久虛擬桌面基礎設施(VDI)裝置。 |
| 入職培訓 | -DeviceTag:<tag> |
在裝置上加上標籤。 |
| 入職培訓 | -Key:<key> |
請指定在 Defender 入口網站中產生的 onboarding 或 offboarding 金鑰。 |
| 離線 | -Offboard |
將裝置離線。 用 -Key:<key> 來指定解除佈建金鑰,或用 .offboarding 來指定 -File:<path> 檔案。 |
| 離線 | -Uninstall |
將裝置從主機板上移除,並卸載在入門過程中新增的元件。 使用 -File:<path> 指定 .offboarding 檔案。 |
| 離線 | -Yes |
直接進行移除作業或解除安裝,不提示確認。 |
| 離線 | -Offline |
允許在離線狀態下完成停用流程。 |
| Configuration | -RemoveMMA:<workspace-id> |
移除指定的 Microsoft 監控代理程式(MMA)工作區連線。 |
| 進階部署 | -MakeConfig |
用預設值生成 DefenderDTconfig.txt 。 |
| 進階部署 | -Stage:<path> |
將所有受支援的 Windows 版本安裝檔下載到指定的絕對路徑。 |
| 進階部署 | -Config:<path> |
從設定檔載入參數。 如果你省略路徑,工具會在當前資料夾中尋找 。DefenderDTconfig.txt |
請使用提升權限的命令提示字元(也就是透過選取 以系統管理員身分執行 所開啟的命令提示字元視窗)來進行上線、移除、解除安裝、更新及產生設定檔。
-Help、-Precheck和-Stage操作不需要系統管理員權限。 當設定檔僅指定預檢查或暫存時,也會繞過管理員檢查。
使用範例
以下範例中的佔位路徑、鍵和代理位址,請替換為環境值。 除了事前檢查和暫存範例外,請使用提升權限的命令提示字元。
執行預設的入職序列,但不要顯示對話框。 該工具使用目前資料夾中的
WindowsDefenderATP.onboarding:DefenderDT.exe -Quiet使用存取金鑰上線、設定 Proxy、允許必要的重新啟動,並防止出現對話方塊:
DefenderDT.exe -Key:<access-key> -Proxy:https://proxy.contoso.com:8080 -AllowReboot -Quiet使用位於網路位置的上線檔案進行上線,而不顯示對話方塊:
DefenderDT.exe -File:\\server.contoso.com\share\WindowsDefenderATP.onboarding -Quiet使用內建的取消上線金鑰將裝置取消上線,且不顯示對話框:
DefenderDT.exe -Offboard -Key:<offboarding-key> -Quiet
使用本機離線檔案將裝置離線,不提示確認,也不顯示對話方塊:
DefenderDT.exe -Offboard -File:C:\Packages\WindowsDefenderATP.offboarding -Yes -Quiet檢查先決條件、顯示詳細輸出,並避免對話:
DefenderDT.exe -PreCheck -Verbose -Quiet下載所有支援的 Windows 版本安裝檔案至絕對暫存路徑:
DefenderDT.exe -Stage:C:\DefenderDT\StagedFiles
使用設定檔
當你想在多次部署中重複使用相同參數時,可以產生設定檔。
在目前資料夾中產生
DefenderDTconfig.txt:DefenderDT.exe -MakeConfig打開
DefenderDTconfig.txt文字編輯器,設定部署參數。 對於接受路徑的參數,請使用絕對路徑。用設定檔執行這個工具。 以下範例是從網路位置載入檔案:
DefenderDT.exe -Config:\\server.contoso.com\share\DefenderDTconfig.txt如果
DefenderDTconfig.txt在目前的資料夾裡,請執行DefenderDT.exe -Config。
使用群組原則部署
使用群組原則立即排程任務來執行部署工具,就像 SYSTEM 提升權限一樣。 關於建立、設定、連結及測試排程任務的通用步驟,請參閱 「使用群組原則的機載裝置」。
請使用這些 Defender 部署工具專屬的數值:
- 將
.onboarding、DefenderDTconfig.txt檔案,以及任何DefenderDT.exe檔案,存放在目標裝置可存取的共用唯讀位置。 - 對於 程式/腳本,請輸入完整的通用命名規則(UNC)路徑至
DefenderDT.exe。 使用檔案伺服器的完整限定網域名稱(FQDN)。 - 對於 新增參數,請輸入所需的 命令列參數。 例如,當 onboarding 檔案不在工具的工作目錄中時,請使用
-File:\\server\share\WindowsDefenderATP.onboarding -Quiet。 - 無論使用者是否已登入,都以
NT AUTHORITY\SYSTEM身分執行此工作,並選取 以最高權限執行。 - 在更廣泛的部署前,先用有限的裝置群組測試群組原則物件(GPO)。
欲了解更多管理控制台資訊,請參閱 群組政策管理控制台。
將裝置下線
你可以透過部署工具,以下列任一方式將裝置解除上線:
- 內嵌式解除委任(預覽):在 Microsoft Defender 入口網站產生帶有解除委任金鑰的部署工具。 解除佈建套件內建在工具裡,所以你不需要另外的解除佈建檔案。 這個金鑰只對它產生的工具實例有效,而且你可以設定最長一年的自訂有效期限。
-
解除連結檔案:從 Defender 入口網站下載解除連結套件,並使用解壓縮後的
.offboarding檔案執行部署工具。
透過內嵌式卸載進行(預覽)
Important
內嵌式解除佈建目前還在預覽階段。 有些資訊涉及預發行產品,可能在上市前會做大幅修改。 Microsoft 對於此處提供的資訊,不作任何明示或默示的保證。
步驟 1:產生帶有取消委任金鑰的部署工具
- 在 Microsoft Defender 入口網站中,移至 系統>設定>端點>解除連結,然後在 選取作業系統 下選取 Windows。 你也可以從裝置庫存中選取Offboard,以開始解除委任。
- 在 Defender 部署工具中,選取「取消上線」。
- 在使用取消上線金鑰產生 Defender 部署工具快顯窗格中,設定套件:
- 名稱:輸入一個獨特且具描述性的套件名稱。
- 組織:確認顯示的組織。
-
有效期限:使用最短的有效期限以降低未經授權的套件使用風險:
- 7天內(預設)
- 30 天內
- 客製化(最長一年)
- 選擇 產生。
步驟二:複製取消佈建金鑰並下載工具
當套件準備就緒時,入口網站會顯示解除委任金鑰和下載選項。
複製離線金鑰並妥善保存。
注意事項
關閉飛出視窗後,你無法再查看該金鑰。 這個金鑰只能搭配你從同一個 flyout 下載的部署工具使用。
選擇 下載部署工具,並根據您組織的需求選擇
.exe或.zip格式。
要檢視你所建立的離職套件,請前往 系統>設定>端點>部署套件。 你可以依照套件類型、狀態和到期日等屬性來篩選清單。
步驟三:在裝置上執行這個工具
把下載的工具複製到你想解除連線的裝置,然後以互動方式或從命令列執行。
以互動方式解除上線:
- 雙擊執行檔。
- 在確認解除連線即將開始的對話方塊中,選取 繼續。
- 輸入你從入口網站複製的離職金鑰,然後選擇 繼續。
- 請等待程序完成。
若要從命令列取消上線,請在提高權限的命令提示字元中使用取消上線金鑰執行該工具:
DefenderDT.exe -Offboard -Key:<offboarding-key>
若要在不顯示對話方塊的情況下解除佈建,請加入以下 -Quiet 參數:
DefenderDT.exe -Offboard -Key:<offboarding-key> -Quiet
替換 DefenderDT.exe 成你下載的執行檔名稱,再替換 <offboarding-key> 成你從入口網站複製的金鑰。
成功完成停用流程後,工具會顯示以下訊息:
Microsoft Defender deployment tool completed, exit code: 0 [Success]
使用卸載檔案進行卸載
若要使用移除檔案將裝置移除,請從 Defender 入口網站下載移除套件,將其傳輸到目標裝置,然後使用該套件執行部署工具。
步驟一:下載離職套件
在 Microsoft Defender 入口網站的 https://security.microsoft.com/securitysettings/endpoints/offboarding 頁面上,於 選取作業系統 下方選取 Windows。 在 Defender 部署工具 中,選取 下載套件 以下載包含解除委任指令碼的 .zip 檔案。
步驟二:執行離岸指令
請完成您想下架的裝置上的以下步驟:
將
.zip檔案複製到目標裝置,並解壓縮.offboarding檔案。在提升權限的命令提示字元中執行部署工具,並指定已解壓縮的
.offboarding檔案的絕對路徑。 例如:DefenderDT.exe -Offboard -File:C:\Packages\WindowsDefenderATP.offboarding在確認對話框輸入 Y 即可繼續。
請等待程序完成。
成功完成停用流程後,工具會顯示以下訊息:
Microsoft Defender deployment tool completed, exit code: 0 [Success]
考量與限制
請檢視 Windows 7 SP1 與 Windows Server 2008 R2 SP1 的一般限制與限制。
一般考量與限制
如果互動序列需要重新啟動,請在重新啟動後再次登入,以便工具繼續使用。 否則,裝置還沒完全接入。
在 Windows Server 2016 及以後版本中,啟用功能「Windows-Defender」步驟可能會失敗,若卸載或移除 Microsoft Defender 防毒軟體。 使用者介面與本地日誌顯示退出代碼
710及EnableFeatureFailed。 日誌中也可能包含錯誤14081和0x3701 The referenced assembly could not be found。 如果你遇到這個問題,請為 Windows Server 開支援案件。
Windows 7 SP1 與 Windows Server 2008 R2 SP1 已知問題與限制
你可能會收到關於由
MsSense.exe或MpCmdRun.exe載入的mpclient.dll、mpcommu.dll、msmplics.dll、mpsvc.dll和sense1ds.dll的警示。 警報應該會隨時間消失。在已安裝桌面體驗套件的 Windows 7 SP1 和 Windows Server 2008 R2 SP1 上,作業中心可能會顯示 Windows 在這部電腦上找不到防毒軟體。 通知並沒有顯示部署問題。
使用 用戶端分析工具 的預覽版,在 Windows 7 SP1 和 Windows Server 2008 R2 SP1 上收集記錄,並針對連線問題進行疑難排解。 分析器需要 PowerShell 5.1 或更新版本。
Microsoft Defender 防毒軟體在這些作業系統上並未提供本地使用者介面。 若要在本地管理 Microsoft Defender 防毒軟體設定,請安裝 PowerShell 5.1 或更新版本。
群組政策設定需要在網域控制器上建立一個包含最新群組政策範本的中央儲存庫。 若要使用本地群組政策編輯器,請手動更新
WindowsDefender.admx並WindowsDefender.adml使用目前的 Windows 11 範本。Defender 端點安全性解決方案會安裝在
C:\Program Files\適用於端點的 Microsoft Defender。在 Windows Server 2008 R2 SP1 上,Defender 部署工具會依下列順序選擇其代理伺服器:
- 透過
-Proxy旗標提供的代理伺服器。 - 執行帳戶的 Internet Explorer 靜態代理設定(如存在)。
- 機器的預設 WinHTTP 代理設定;否則,為直接連線。
因此,如果代理只存在於列出的 Defender 登錄設定中,請在上線和解除上線時再次指定。
疑難排解
請檢視 Defender 部署工具日誌,尋找安裝及新手導入時的問題。 該日誌位於:
C:\ProgramData\Microsoft\DefenderDeploymentTool\DefenderDeploymentTool-<COMPUTERNAME>.log
該工具也會在這些 Windows 事件日誌中記錄事件:
- 上線:Windows 日誌 > 應用程式>來源:WDATPOnboarding
- 取消上線:Windows 日誌 > 應用程式 > 來源:WDATPOffboarding
要確認安裝成功,請完成以下檢查:
請用以下指令驗證服務是否正在執行:
Sc.exe query sense Sc.exe query windefend你應該會看到以下輸出:
SERVICE_NAME: sense TYPE : 10 WIN32_OWN_PROCESS STATE : 4 RUNNING (STOPPABLE, NOT_PAUSABLE, ACCEPTS_PRESHUTDOWN) WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0 SERVICE_NAME: windefend TYPE : 10 WIN32_OWN_PROCESS STATE : 4 RUNNING (STOPPABLE, NOT_PAUSABLE, ACCEPTS_SHUTDOWN) WIN32_EXIT_CODE : 0 (0x0) SERVICE_EXIT_CODE : 0 (0x0) CHECKPOINT : 0x0 WAIT_HINT : 0x0關於 Defender 防毒軟體的日誌、設定及其他診斷資訊,請參見「收集 Microsoft Defender 防毒軟體診斷資料」。
使用用戶端分析工具來收集日誌並排除 Windows 上的連線問題。
出口代碼
對於透過軟體發行解決方案進行大規模部署,請監控以下退出代碼:
| 錯誤碼 | 意義 |
|---|---|
| 0 | 序列成功完成 |
| 1 | 另一個實例已經在運行中 |
| 2 | 裝置已接入:無需行動 |
| 3 | 下線功能僅適用於已上線的裝置 |
| 5 | 此工具有新版本可用 |
| 6 | 工具已更新至最新版本 |
| 10 | 必須重啟才能繼續。 除非 NoResumeAfterReboot 指定參數,否則工具會自動恢復。 |
| 11 | 未能驗證簽名 |
| 12 | 未執行流程緩解政策 |
| 20 | 找不到檔案 |
| 30 | 缺少所需的資源檔案 |
| 40 | 請以管理員權限執行該工具 |
| 50 | 不支援作業系統 |
| 70 | 偵測到設定檔錯誤 |
| 80 | 品質遙測失敗 |
| 90 | 前置檢查失敗 |
| 100 | 資訊清單檔案已損毀 |
| 200 | 入職失敗:感測器初始化錯誤 |
| 201 | 入職檔案缺失或未指定 |
| 210 | 未能重新載入 Defender 防毒軟體引擎 |
| 300 | 下線失敗 |
| 301 | 下線檔案遺失或未指定 |
| 302 | 離職檔案無效 |
| 400 | 下載失敗:無法取得所需元件 |
| 500 | 安裝失敗:無法安裝所需元件 |
| 600 | 更新失敗:無法套用更新套件 |
| 610 | 不支援的更新檔案 |
| 700 | 系統準備失敗 |
| 710 | 未能啟用 Defender 防毒軟體功能 |
| 720 | 未能解除安裝 System Center Endpoint Protection(SCEP) |
| 730 | 未能下載並套用最新的主權雲手動簽章 |
| 740 | 無法設定主權雲端的 ADL 登錄設定 |
| 900 | 無法卸載 Defender 的元件 |
| 920 | 未能移除所請求的 Microsoft 監控代理(MMA)工作區 |
| 930 | 無效的 MMA 工作區 ID |
| 1000 | 發生了未說明的錯誤 |