Defender 展開ツールは、Defender エンドポイント セキュリティ ソリューションでサポートされているすべての Windows バージョンのオンボードを合理化するように設計された、軽量で自己更新型のアプリケーションです。 このツールは前提条件の処理を行い、古いソリューションからの移行を自動化し、複雑なオンボード スクリプト、個別のダウンロード、手動インストールの必要性を排除します。
ツールのユーザー インターフェイスを使用して、管理者はツールをダブルクリックし、対話型のインストールとオンボードシーケンスに従うことができます。 大規模なデプロイの場合、このツールは高度なコマンドライン パラメーターを備えた自動化オプションを提供します。これにより、オーケストレーション プラットフォームやカスタムデプロイ ツール (グループ ポリシー など) と統合しながら、Intuneや Defender for Cloud などの他の Microsoft ソリューション統合を通じて提供されるエクスペリエンスはそのまま残すことができます。
ツールでサポートされる機能は次のとおりです。
前提条件の処理: ツールは、必要な更新プログラムをチェックし、ブロックの問題を修復し、デバイスが Defender オンボードの準備ができている状態であることを確認します。
ログ記録: すべての操作が詳細ログにローカルに記録されます。
冗長インストールの回避: Defender が既に存在する場合、ツールは冗長インストールをスキップします。
UI フィードバック: ツールは、終了コードの代わりにエラーの説明を含む UI フィードバックを提供します。
パッシブ モードのサポート: サーバー オペレーティング システムと Windows 7 では、Defender ウイルス対策をパッシブ モードに設定できます。 これは、Microsoft 以外のマルウェア対策ソリューションから移行する場合に役立ちます。
オートメーション: このツールでは、さまざまなコマンド ライン オプションがサポートされています。
デバイスの処理: Virtual Desktop Infrastructure (VDI) デバイスのサポートにより、同じホスト名で削除および再作成されたデバイスを Defender ポータルで 1 つのデバイスとして表示できます。
ヘルプ: 組み込みのヘルプ関数には、使用可能なすべてのコマンド ライン オプションが表示されます。
構成ファイル: 一括デプロイの効率を高め、エラーが発生しにくい再利用可能な構成ファイルを生成できます。
接続なしで作業する: 接続が一時的に使用できない場合は、オフラインオンボードとオフボードが可能です。
対話型のダブルクリック エクスペリエンスを使用すると、ツールは同じディレクトリ内の WindowsDefenderATP.onboarding ファイルを自動的に利用します。 ほとんどの前提条件の更新プログラムと最新の Defender コンポーネントのインストールを処理し、デバイスを Defender サービスに接続します。 必要に応じて、もう一度サインインした後にデバイスを再起動してインストールを完了するように求められます。
より高度で大規模なデプロイのために、ツールには、コマンド ライン パラメーターまたは構成ファイルを使用して追加の調整された手順を実行する機能が用意されています。
ツールのダウンロード後に完全なコマンド 参照を表示するには、次を実行します: DefenderDT.exe -?。
サポートされるオペレーティング システム
Defender 展開ツールでは、Windows 7 SP1、Windows Server 2008 R2 SP1、Windows Server 2012 R2、2016、2019、2022、2025、Windows 10 (バージョン 1809 以降)、およびすべてのバージョンのWindows 11がサポートされています。
注:
展開ツールが Windows 7 SP1 および Windows Server 2008 R2 SP1 デバイスにインストールする Defender エンドポイント セキュリティ ソリューションはプレビュー段階にあり、新しいバージョンの Windows およびWindows Serverの場合とは異なります。 詳細については、「Windows 7 SP1 および Windows Server 2008 R2 SP1 デバイス用の Defender エンドポイント セキュリティ ソリューションを展開する」を参照してください。
前提条件
サポートされているすべての Windows および Windows Server デバイスに関連する前提条件と、Windows 7 SP1 および Windows Server 2008 R2 SP1 デバイスに固有の前提条件があります。
一般的な前提条件
ほとんどの操作には管理特権が必要です。
テナントでプレビュー機能を有効にする必要があります。
ドメイン definitionupdates.microsoft.com へのアクセス。 このツールは、このドメインからダウンロードおよび更新されます。 ダウンロードしたファイルはコンテンツ配布プラットフォームでホストされるため、他の Defender クラウド サービスとは異なり、静的または予測可能な IP 範囲は関連付けされません。
このツールは続行する前に特定のテナントに対する接続をチェックしますが、統合 *.endpoint.security.microsoft.com/*へのアクセスなど、その他の接続要件は、製品で使用する (追加の) 機能に適用されます。 Defender for Endpoint サービスとの接続を確保するためのネットワーク環境の構成に関するページを参照してください。
Windows 7 SP1 および Windows Server 2008 R2 SP1 のその他の前提条件
デバイスは、x64 バージョンの Windows 7 SP1 または Windows Server 2008 R2 SP1 を実行している必要があります。 再起動を回避し、必要なインストール時間を大幅に短縮するために、最新の更新プログラムをインストールすることをお勧めします。
Defender 展開ツールを Windows 7 SP1 または Windows Server 2008 R2 SP1 で実行するには、少なくとも SHA2 コード署名の更新プログラム KB4474419をインストールする必要があります。
Server 2008 R2 SP1 デバイスでは、.NET 3.5 以降のバージョンの .NET フレームワークもインストールする必要があります。
R2 SP1 は、少なくとも SHA2 コード署名の更新プログラムをインストールする必要があります。
サービス スタック更新プログラム (SSU) (KB4490628)。 Windows Updateを使用すると、必要な SSU が自動的に提供されます。
SHA-2 更新プログラム (KB4474419) は、2019 年 9 月 10 日にリリースされました。 Windows Updateを使用すると、必要な SHA-2 更新プログラムが自動的に提供されます。
注:
Windows 7 SP1、Windows Server 2008 R2、Windows Server 2012の場合、インストールされる Defender エンドポイント セキュリティ ソリューションは現在パブリック プレビュー段階です。 Windows 7 SP1 および Windows Server 2008 R2 デバイスの Defender エンドポイント セキュリティの詳細については、「Windows 7 SP1 および Windows Server 2008 R2 SP1 デバイス用の Defender エンドポイント セキュリティ ソリューションを展開する」を参照してください。
ツールをダウンロードする
Microsoft Defender ポータル (security.microsoft.com) で、System>Settings>Endpoints>Onboarding に移動します。
[手順 1] ドロップダウン メニューで、[ Windows (プレビュー)] を選択します。
[ パッケージまたはファイルをダウンロードして適用してデプロイする] で、[ パッケージのダウンロード ] ボタンを選択します。 これにより、Defender 実行可能ファイルとオンボード ファイル パッケージがダウンロードされます。
注:
オフボードの場合は、[デバイス管理] セクションで [オフボード] を選択し、[手順 1] ドロップダウン メニューで [Windows 10] と [11] を選択し、[パッケージのダウンロード] ボタンを選択します。 これにより、オフボード ファイル パッケージのみがダウンロードされます。オンボードとオフボードの両方で同じであるため、Defender 展開ツールの実行可能ファイルはダウンロードされません。
デバイスに Defender エンドポイント セキュリティを展開する
Defender デプロイ ツールは、対話形式または非対話型で使用できます。
対話型の使用
このツールでは、1 台または限られた数のデバイスへのデプロイに適した 2 つの対話型エクスペリエンス (既定の動作に変更を加えずに"ダブルクリック" クイック シングル マシン オンボード エクスペリエンス) と、柔軟性を高める手動のコマンドライン エクスペリエンスがサポートされています。
クイック "ダブルクリック" の既定のインストールを使用するには:
実行可能ファイルをダブルクリックして起動します。
表示されるダイアログで、[続行] を選択 します。
ツールは、ツールが実行されているディレクトリ内の WindowsDefenderATP.onboarding ファイルを 探し、既定のインストールとオンボード操作を実行します。
非対話型の使用
コマンド ライン インターフェイスを使用して、すべてのインストール操作とオンボード操作を手動で実行することもできます。 さらに、コマンド ライン インターフェイスでは、前提条件チェックの実行など、さまざまな他の操作がサポートされています。
完全なコマンド リファレンスを表示するには、 DefenderDT.exe -? を実行します。
高度かつ大規模なデプロイ
Defender 展開ツールは、organizationがソフトウェアの展開に使用するグループ ポリシー、Microsoft Configuration Manager、その他のツールなど、管理ツールによって実行される調整されたシーケンスの一部として非対話型で使用できます。
この目的のために、ツールにはオプションのコマンド ライン パラメーターが用意されています。これにより、オンボード操作をカスタマイズして、さまざまなシナリオをサポートできます。
環境内で繰り返し展開するシナリオでは、コマンド ラインの代わりに構成ファイルを使用してパラメーターを渡すことができます。 構成ファイルを生成するには、 -makeconfig パラメーターを使用してツールを実行します。 ファイルが作成されたら、テキスト エディターでファイルを開き、展開シナリオに合わせてオプションを構成します。
使用例を参照してください。
使用例
次の例は、ツールの使用方法を示しています。
設定を変更せずに、操作せずに Defender 展開ツールを実行します。
DefenderDT.exe -Quietツールと同じディレクトリにある WindowsDefenderATP.onboarding ファイルを 使用して、既定のオンボード シーケンスを実行し、プロキシ経由で接続し、再起動が必要な場合は、要求せずに開始します。 コンソール ウィンドウは表示されません。
DefenderDT.exe -Proxy:192.168.0.255:8080 -AllowReboot -Quietオンボード シーケンスを実行するには、ネットワークの場所に格納されている .onboarding ファイルを使用します。 コンソール ウィンドウは表示されません。
DefenderDT.exe -File:\\server\share\Defender.onboarding -Quietオフボード操作を実行します。 承認を求めないでください。 コンソール ウィンドウを表示しません。
DefenderDT.exe -Offboard -File:c:"\Defender deployment tooltest\WindowsDefenderATPOffboardingScript_valid_until_2025-04-02.offboarding" -YES -Quiet前提条件のチェックを実行し、ダイアログ ボックスを表示せずに詳細出力を表示します。
DefenderDT.exe -PreCheck -Verbose -Quietステージングに使用する更新プログラムとインストール ファイルを現在のディレクトリにダウンロードします。
DefenderDT.exe -Stage
構成ファイルを作成し、編集した後、それを使用して複数のパラメーターをツールに渡して、ステージングされたインストール ファイルを使用してインストールを実行します。
手順 1: 構成ファイルを生成する
DefenderDT.exe -makeconfig手順 2: メモ帳などのテキスト エディターを使用して、ディレクトリに作成された MdeConfig.txt ファイルを開き、使用するパラメーターを指定します。 見本:
# Only absolute paths can be used for the parameters accepting paths # Configures the tool to perform offboarding. # Add the parameter "YES" to proceed with offboarding without user approval. # Offboard: False # Used with "Offboard" and "Uninstall" parameters. # Yes: False # Downloads the installation files for all Windows versions supported by the tool to a specific location for staging purposes. # Stage: # Specifies the path to the folder containing the installation files. To stage installation files, use the "Stage" parameter. # Source: # Specifies the full path to the .onboarding or .offboarding file if it is not placed in the current folder. # File: # Proxy to use during and after installation. Empty string by default. Proxy: # Prevents any dialogs from displaying. False by default. Quiet: False # Allows device reboots if needed. False by default AllowReboot: False # Prevents the tool from resuming activities after a reboot. False by default. NoResumeAfterReboot: False # Windows Server only. Sets Defender antivirus to run in passive mode. Passive: False # Installs updates but does not perform onboarding, even if an onboarding file is present. False by default. UpdateOnly: False # Displays detailed information. False by default. Verbose: False # Checks for prerequisites and logs results but does not proceed with installation or onboarding. False by default. Precheck: False # Offboards the device and uninstalls any components that were added during onboarding. # Will use the .offboarding file in the current folder if no path was specified. # Add the parameter "YES" to proceed without user approval. Uninstall: False # Optionally removes the specified workspace connection used by Microsoft Monitoring Agent (MMA). Empty string by default. RemoveMMA: # Allows offboarding to proceed even if there is no connectivity. False by default. Offline: False手順 3: 構成ファイルを使用してツールを実行します。
DefenderDT.exe -File:\\server\DDT\Defenderconfig.txtMdeConfig.txt ファイルがツールと同じディレクトリに格納されている場合は、パスを指定する必要はありません。
デプロイにグループ ポリシーを使用する
次の手順では、グループ ポリシーを使用してツールを実行するスケジュールされたタスクを作成する方法を示します。
ファイル DefenderDT.exe と WindowsDefenderATP.onboarding を 、デバイスからアクセスできる共有の場所に配置します。 MDEConfig.txt 構成ファイル を以前に作成した場合は、同じ場所に配置します。
新しいグループ ポリシー オブジェクト (GPO) を作成するには、グループ ポリシー管理コンソール (GPMC) を開き、構成するオブジェクトグループ ポリシー右クリックし、[新規] を選択します。 表示されるダイアログ ボックスに新しい GPO の名前を入力し、[ OK] を選択します。
グループ ポリシー管理コンソールを開き、構成するグループ ポリシー オブジェクト (GPO) を右クリックし、[編集] を選択します。
グループ ポリシー管理エディターで、コンピューターの構成>Preferences>Control パネルの設定に移動します。
[ スケジュールされたタスク] を右クリックし、[ 新規] をポイントし、[ イミディエイト タスク (Windows 7 以上)] を選択します。
開いた [タスク ] ウィンドウで、[ 全般 ] タブに移動します。
[ セキュリティ オプション ] で[ ユーザーまたはグループの変更] を選択し、「 SYSTEM」と入力し、[ 名前の確認 ] を選択して [OK] を選択します。 NT AUTHORITY\SYSTEM は、タスクが実行されるユーザー アカウントとして表示されます。
[ユーザーがログオンしているかどうかに関係なく実行する] を選択し、[最高の権限で実行する] チェックボックスをオンにします。
[ 名前 ] フィールドに、スケジュールされたタスクの適切な名前を入力します。
[アクション] タブに移動し、[新規] を選択します。 [アクション] フィールド で [プログラムの開始 ] が選択されていることを確認します。 共有DefenderDDT.exeアプリケーションのファイル サーバーの完全修飾ドメイン名 (FQDN) を使用して、完全な UNC パス を 入力します。
[ 引数の追加 (省略可能)] フィールドに、使用する パラメーター を入力します。 たとえば、ツールの作業ディレクトリにないオンボード ファイルを使用するには、オンボード ファイルへの完全な UNC パスを持つ -file: パラメーターを指定します (たとえば、
-file: \\server\share\WindowsDefenderATP.onboarding)。[OK] を選択し、開いている GPMC ウィンドウをすべて閉じます。
GPO を組織単位 (OU) にリンクするには、右クリックして 既存の [GPO をリンク] を選択します。 表示されるダイアログ ボックスで、リンクする グループ ポリシー オブジェクトを選択し、[OK] を選択します。
考慮事項と制限事項
一般的な考慮事項と制限事項、および Windows 7 SP1 および Windows Server 2008 R2 SP1 デバイスに固有のその他の考慮事項と制限事項を次に示します。
一般的な考慮事項と制限事項
対話型エクスペリエンスを使用していて、シーケンスを完了するために再起動が必要な場合は、再起動後に再度サインインして再開する必要があります。 それ以外の場合、デバイスは完全にオンボードされません。
-proxy パラメーターを使用する場合、Defender デプロイ ツールの操作にのみ適用されます。 コマンド ライン ヘルプ リファレンスのパラメーターの説明にもかかわらず、インストール後に使用する Defender エンドポイント セキュリティのレジストリでのプロキシ構成は設定されません。 ツールと Defender の両方で、システム全体 (Windows) レベルで構成されているプロキシは関係なく使用されることに注意してください。 システム全体ではなく、コンピューター上の Defender エンドポイント セキュリティ サービスに使用するプロキシを具体的に構成する場合は、「 プロキシを使用して Defender for Endpoint サービスに接続するようにデバイスを構成する」を参照してください。
Windows Server 2016以降では、Defender ウイルス対策機能がアンインストールまたは削除されると、機能 'Windows-Defender' の有効化手順中にエラーが発生する可能性があります。 これは、ユーザー インターフェイスのローカル ログの [終了コード 710 でのシーケンスの完了] とエラーの説明 EnableFeatureFailed で確認できます。 ローカル ログでは、参照先アセンブリが見つかりませんでした0x3701説明を含むエラー 14081 を 見つけることもできます。 このエラーは、通常オンボード ツールによって解決されるため、Defender ウイルス対策機能ファイルまたはソース ファイルに関する問題を示すものではありません。 この問題が発生した場合は、Windows サーバーのサポート ケースを開きます。
Windows 7 SP1 および Windows Server 2008 R2 SP1 の既知の問題と制限事項
mpclient.dll、mpcommu.dll、 mpsvc.dll、 msmplics.dll、およびmpcmdrun.exeまたは mssense.exeによって読み込まれた sense1ds.dll に関するアラートが表示される場合があります。 これらは時間の経過と同時に解決される必要があります。
Windows 7 SP1 とデスクトップ エクスペリエンス パックがインストールされた Windows Server 2008 R2 SP1 では、Action Center Windows からこのコンピューターにウイルス対策ソフトウェアが見つからなかったという通知が表示される場合があります。 これは問題を示すものではありません。
クライアント アナライザー ツールのプレビュー ("ベータ") バージョンを使用すると、Windows 7 SP1 と Windows Server 2008 R2 SP1 でログを収集し、接続のトラブルシューティングを実行できます。 PowerShell 5.1 以降をインストールする必要があります。
ウイルス対策用のローカル ユーザー インターフェイスはありません。 PowerShell を使用してウイルス対策設定をローカルで管理する場合は、バージョン 5.1 以降が必要です。
グループ ポリシーを使用した構成は、ドメイン コントローラー上の更新されたグループ ポリシー テンプレートを含む中央ストアを使用してサポートされます。 ローカル グループ ポリシーの構成では、ローカル グループ ポリシー エディターを使用して設定を適用する場合は、テンプレート (WindowsDefender.admx/WindowsDefender.adml) を新しいバージョン (Windows 11) に手動で更新する必要があります。
Defender エンドポイント セキュリティ ソリューションは、
C:\Program Files\Microsoft Defender for EndpointWindows 7 デバイスは、KB5005292を適用して最新の Sense バージョンに更新するまで、ポータルに サーバー として表示されることがあります。
Defender ウイルス対策を Windows 7 のパッシブ モードにするには、-passive パラメーターを Defender 展開ツールに渡します。 ただし、現在のところ、Windows サーバーのように ForceDefenderPassiveMode レジストリ キーを使用して、後でアクティブ モードに切り替えすることはできません。 アクティブ モードに切り替えるには、オフボードとアンインストールを行い、パッシブ モード パラメーターなしで Defender 展開ツールをもう一度実行する必要があります。
トラブルシューティング
Defender 展開ツール ログを参照して、インストールとオンボード中に問題が発生したかどうかを確認できます。 デプロイ ツール ログは次の場所にあります。
C:\ProgramData\Microsoft\DefenderDeploymentTool\DefenderDeploymentTool-<COMPUTERNAME>.log
イベントは、次の Windows イベント ログにも書き込まれます。
オンボード: Windows ログ > アプリケーション > ソース: WDATPOnboarding
オフボード: Windows ログ > アプリケーション > ソース: WDATPOffboarding
インストールが正常に成功したかどうかをテストするには、次のチェックを実行します。
サービスが実行されているかどうかを確認する
Sc.exe query senseSc.exe query windefend両方のサービスに対して、次のような内容が表示されます。
設定やその他の情報など、Defender ウイルス対策の詳細なログ収集については、次のコマンドを実行できます。
C:\Program Files\Microsoft Defender for Endpoint\MpCmdRun.exe” -GetFiles -SupportLogLocation <FOLDEROFCHOICE>クライアント アナライザー ツールの最新プレビュー バージョンは、Windows 7 SP1 および Windows Server 2008 R2 SP1 でログを収集し、接続のトラブルシューティングを実行するためにも使用できます。 PowerShell 5.1 以降をインストールする必要があります。