ローカルスクリプトを使用した Windows デバイスのオンボード

2025-10-21
適用対象: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

個々のデバイスを Defender for Endpoint に手動でオンボードすることもできます。ネットワーク内のすべてのデバイスのオンボードにコミットする前に、サービスをテストするときに一部のデバイスをオンボードすることが必要になる場合があります。

重要

この記事で説明するスクリプトは、デバイスを Defender for Endpoint に手動でオンボードする場合に推奨されます。これは、限られた数のデバイスでのみ使用する必要があります。運用環境に展開する場合は、Intune、グループポリシー、Configuration Managerなど、その他の展開オプションに関するページを参照してください。

Defender for Endpoint の展開のさまざまなパスを確認するには、「 Defender for Endpoint アーキテクチャとデプロイ方法を識別する」を参照してください。

デバイスのオンボード

サービスオンボードウィザードからダウンロードした構成パッケージ .zip ファイル (WindowsDefenderATPOnboardingPackage.zip) を開きます。 Microsoft Defender ポータルからパッケージを取得することもできます。

注:

[エンドポイント] セクションが表示されない場合は、他の Defender 機能 (インシデントやハンティングなど) にアクセスするか、環境が初期化されるまで数分待ってください。また、必要なロール (セキュリティ管理者など) と適切なライセンスがあることを確認します。

ナビゲーションウィンドウで、設定>Endpoints>Device management>Onboarding を選択します。
オペレーティングシステムとして [Windows 10] または [Windows 11] を選択します。
[ デプロイ方法 ] フィールドで、[ ローカルスクリプト] を選択します。
[ パッケージのダウンロード ] を選択し、.zip ファイルを保存します。
構成パッケージの内容を、オンボードするデバイス上の場所 (デスクトップなど) に抽出します。 WindowsDefenderATPLocalOnboardingScript.cmd という名前のファイルが必要です。
デバイスで管理者特権のコマンドラインプロンプトを開き、スクリプトを実行します。
1. [スタート] をクリックし、「cmd」と入力します。
2. [コマンドプロンプト] を右クリックして [管理者として実行] を選択します。
スクリプトファイルの場所を入力します。ファイルをデスクトップにコピーした場合は、次のように入力します。 %userprofile%\Desktop\WindowsDefenderATPLocalOnboardingScript.cmd
Enter キーを押すか、[OK] を選択します。
「Y」と入力し、プロンプトが表示されたら「」と入力します。
スクリプトが完了すると、"任意のキーを押して続行..." と表示されます。任意のキーを押して、デバイスの手順を完了します。

デバイスが準拠しており、センサーデータが正しくレポートされていることを手動で検証する方法については、「Microsoft Defender for Endpointオンボードの問題のトラブルシューティング」を参照してください。

ヒント

デバイスのオンボード後、検出テストを実行して、デバイスがサービスに適切にオンボードされていることを確認できます。詳細については、「新しくオンボードされたMicrosoft Defender for Endpoint エンドポイントで検出テストを実行する」を参照してください。

サンプルコレクション設定を構成する

デバイスごとに構成値を設定して、詳細な分析のためにファイルを送信するMicrosoft Defender XDR要求が行われたときに、デバイスからサンプルを収集できるかどうかを示すことができます。

regedit を使用するか、.reg ファイルを作成して実行することで、デバイスでサンプル共有設定を手動で構成できます。

構成は、次のレジストリキーエントリによって設定されます。

Path: "HKLM\SOFTWARE\Policies\Microsoft\Windows Advanced Threat Protection"
Name: "AllowSampleCollection"
Value: 0 or 1

ここで、名前の種類は D-WORD です。使用可能な値は次のとおりです。

0 - このデバイスからのサンプル共有を許可しない
1 - このデバイスからすべてのファイルの種類を共有できます

レジストリキーが存在しない場合の既定値は 1 です。

検出テストを実行してオンボードを検証する

デバイスのオンボード後、検出テストを実行して、デバイスがサービスに適切にオンボードされていることを確認できます。詳細については、「新しくオンボードされた Microsoft Defender for Endpoint デバイスで検出テストを実行する」を参照してください。

ローカルスクリプトを使用してデバイスをオフボードする

セキュリティ上の理由から、オフボードデバイスに使用されるパッケージは、ダウンロード日の 7 日後に期限切れになります。デバイスに送信された期限切れのオフボードパッケージは拒否されます。オフボードパッケージをダウンロードすると、パッケージの有効期限が通知され、その日付がパッケージファイル名に含まれます。

注:

オンボードポリシーとオフボードポリシーを同時に同じデバイスに展開することはできません。そうしないと、予期しない競合が発生する可能性があります。

Microsoft Defender ポータルからオフボードパッケージを取得します。
1. ナビゲーションウィンドウで、設定>Endpoints>Device management>Offboarding を選択します。
2. オペレーティングシステムとして [Windows 10] または [Windows 11] を選択します。
3. [ デプロイ方法 ] フィールドで、[ ローカルスクリプト] を選択します。
4. [ パッケージのダウンロード ] を選択し、.zip ファイルを保存します。
デバイスがアクセスできる共有の読み取り専用の場所に、.zip ファイルの内容を抽出します。 WindowsDefenderATPOffboardingScript_valid_until_YYYY-MM-DD.cmd という名前のファイルが必要です。
デバイスで管理者特権のコマンドラインプロンプトを開き、スクリプトを実行します。
1. [スタート] をクリックし、「cmd」と入力します。
2. [コマンドプロンプト] を右クリックして [管理者として実行] を選択します。
スクリプトファイルの場所を入力します。ファイルをデスクトップにコピーした場合は、次のように入力します。 %userprofile%\Desktop\WindowsDefenderATPOffboardingScript_valid_until_YYYY-MM-DD.cmd
Enter キーを押すか、[OK] を選択します。

重要

オフボードすると、デバイスはポータルへのセンサーデータの送信を停止しますが、デバイスからのデータ (以前のアラートへの参照を含む) は最大 6 か月間保持されます。

デバイスの構成を監視する

オンボードの問題のトラブルシューティングに関するページのさまざまな検証手順に従って、スクリプトが正常に完了し、エージェントが実行されていることを確認できます。

監視は、ポータルで直接実行することも、さまざまなデプロイツールを使用して行うこともできます。

ポータルを使用してデバイスを監視する

Microsoft Defender ポータルに移動します。
[ デバイスインベントリ] を選択します。
デバイスが表示されていることを確認します。

ヒント

さらに多くの情報を得るには、 Tech Community 内の Microsoft Security コミュニティ (Microsoft Defender for Endpoint Tech Community) にご参加ください。

フィードバック

このページはお役に立ちましたか?

次の方法で共有

ローカル スクリプトを使用した Windows デバイスのオンボード

デバイスのオンボード

サンプル コレクション設定を構成する