Report Stale Devices Scheduled

Scheduled report of stale devices based on last activity date and platform.

Description

Identifies and lists devices that haven't been active for a specified number of days. Automatically sends a report via email.

Setup regarding email sending

This runbook sends emails using the Microsoft Graph API. To send emails via Graph API, you need to configure an existing email address in the runbook customization.

This process is described in detail in the Setup Email Reporting documentation.

Location

Organization → Devices → Report Stale Devices (Scheduled)

Full Runbook name

rjgit-org_devices_report-stale-devices_scheduled

Permissions

Application permissions

• Type: Microsoft Graph

  • DeviceManagementManagedDevices.Read.All

  • Directory.Read.All

  • Device.Read.All

  • Mail.Send

Parameters

Days

Number of days without activity to be considered stale.

Property	Value
Required	false
Default Value	30
Type	Int32

MaxDays

Optional maximum number of days without activity. If set, only devices inactive between Days and MaxDays will be included.

Property	Value
Required	false
Default Value
Type	Int32

Windows

Include Windows devices in the results.

Property	Value
Required	false
Default Value	True
Type	Boolean

MacOS

Include macOS devices in the results.

Property	Value
Required	false
Default Value	True
Type	Boolean

iOS

Include iOS devices in the results.

Property	Value
Required	false
Default Value	True
Type	Boolean

Android

Include Android devices in the results.

Property	Value
Required	false
Default Value	True
Type	Boolean

EmailFrom

The sender email address. This needs to be configured in the runbook customization

Property	Value
Required	false
Default Value
Type	String

UseUserScope

Enable user scope filtering to include or exclude devices based on primary user group membership.

Property	Value
Required	false
Default Value	False
Type	Boolean

IncludeUserGroup

Only include devices whose primary users are members of this group. Requires UseUserScope to be enabled.

Property	Value
Required	false
Default Value
Type	String

ExcludeUserGroup

Exclude devices whose primary users are members of this group. Requires UseUserScope to be enabled.

Property	Value
Required	false
Default Value
Type	String

EmailTo

Can be a single address or multiple comma-separated addresses (string). The function sends individual emails to each recipient for privacy reasons.

Property	Value
Required	true
Default Value
Type	String

Back to Runbook Reference overview