デバイスを段階的に廃止
複数のデバイスを削除または段階的に廃止します
説明
この runbook は、デバイス ID またはシリアル番号のカンマ区切りリストに基づいて、複数のデバイスを段階的に廃止します。必要に応じて、Intune でデバイスをワイプし、対応する Entra ID のデバイス オブジェクトを削除または無効化できます。さらに、各デバイスに Microsoft Defender for Endpoint のタグを付けて、修復対象から除外されていることを示すこともできます。注: 除外タグはデバイスに適用されますが、ポータルで一度（[デバイス] > [タグの管理] > [新しいタグの作成]）作成されるまでは、Defender ポータルの「タグ」フィルターには表示されません。
Microsoft Defender for Endpoint の除外タグ
Microsoft Defender for Endpoint にはネイティブの 除外状態 （デバイス インベントリ フィルターでは 除外済み / 除外されていないと表示されます）。この状態は Defender ポータルからのみ設定でき、 API はありません デバイスのネイティブな除外状態をプログラムで設定するための。
ネイティブの除外状態を自動化できないため、この runbook では代わりにカスタム デバイス タグ（既定値 ExcludeFromRemediation）を Microsoft Defender for Endpoint からデバイスを除外する が有効になっている場合に適用します。リスト内の各デバイスは Entra ID のデバイス ID で検索され、 POST /api/machines/{id}/tags経由でタグ付けされ、除外されたデバイスをフィルターして対象にするために使用できるマーカーが提供されます。
一度だけの設定: タグをフィルター可能にする
ポータルの 「タグ」 フィルターには、ポータル経由で作成されたタグのみが一覧表示されます。API だけで設定されたタグはデバイスに付与され、デバイス ページでは表示されますが、 一致 それだけでは「タグ」フィルターには表示されません。
除外タグを表示可能にし、 Defender デバイス インベントリでフィルターに使用できるようにするには、1 つのクライアントをポータルから手動で一度タグ付けする必要があります（デバイスを選択 > タグの管理 > 「新しいタグの作成」、同じタグ値を正確に使用）。この 1 回限りの手順の後、タグは既知のフィルター可能なタグになり、この runbook で大規模にデバイスへ適用できるようになります。
注意: このタグはラベルにすぎず、デバイスのネイティブな除外状態は設定されず、単独では修復効果もありません。効果があるのは、Defender のデバイス グループまたは自動化ルールがこのタグ値に一致するよう明示的に構成されている場合だけです。このようなルールはポータルの 「タグ」 フィルターとは独立してタグ値そのものに直接一致するため、この 1 回限りの手動手順は、ポータル UI でタグをフィルター対象として選択できるかどうかにのみ影響します。
Intune で見つからないシリアル番号指定のデバイスには Entra ID のデバイス ID がないため、Defender ではタグ付けされません。
参照 デバイスタグの作成と管理 詳細について。
場所
組織 → デバイス → Outphase Devices
完全な Runbook 名
rjgit-org_devices_outphase-devices
アクセス許可
アプリケーションのアクセス許可
種類: Microsoft Graph
DeviceManagementManagedDevices.PrivilegedOperations.All
DeviceManagementManagedDevices.ReadWrite.All
DeviceManagementServiceConfig.ReadWrite.All
Device.Read.All
種類: WindowsDefenderATP
Machine.Read.All
Machine.ReadWrite.All
RBAC ロール
クラウド デバイス管理者
パラメーター
DeviceListChoice
リストにデバイス ID が含まれるか、シリアル番号が含まれるかを決定します。
必須
true
既定値
0
種類
Int32
DeviceList
デバイス ID またはシリアル番号のカンマ区切りリスト。
必須
true
既定値
種類
文字列
intuneAction
デバイスをワイプするか、Intune から削除するか、Intune 操作をスキップするかを決定します。
必須
false
既定値
2
種類
Int32
aadAction
Entra ID のデバイスを削除するか、無効にするか、Entra ID の操作をスキップするかを決定します。
必須
false
既定値
2
種類
Int32
wipeDevice
intuneAction から派生した内部フラグ。
必須
false
既定値
True
種類
ブール値
removeIntuneDevice
intuneAction から派生した内部フラグ。
必須
false
既定値
False
種類
ブール値
removeAutopilotDevice
「デバイスを Autopilot から削除する」（最終値: true）または「デバイスを Autopilot に保持する」（最終値: false）で、デバイスを Autopilot データベースから削除するかどうかを制御します。
必須
false
既定値
True
種類
ブール値
removeAADDevice
aadAction から派生した内部フラグ。
必須
false
既定値
True
種類
ブール値
disableAADDevice
aadAction から派生した内部フラグ。
必須
false
既定値
False
種類
ブール値
excludeFromDefender
true に設定すると、各デバイスに指定された除外タグを使用して Microsoft Defender for Endpoint でタグ付けされます。false に設定すると、Defender の手順は完全にスキップされます。
必須
false
既定値
False
種類
ブール値
defenderExclusionTag
Microsoft Defender for Endpoint でデバイスに追加され、除外済みであることを示すタグ。既定値は "ExcludeFromRemediation" です。
必須
false
既定値
ExcludeFromRemediation
種類
文字列
最終更新
役に立ちましたか？