Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Auto Approve Driver Updates Scheduled

Approve pending driver updates in Intune driver update policies

This is a scheduled runbook. It is designed to run on a recurring schedule rather than being triggered for a single object. See Scheduling for details on how to configure runbook schedules.

Description

Approves driver updates that are waiting for review in Intune driver update policies, so drivers roll out without manual approval. The scope can be narrowed to certain policies, driver names, classes, manufacturers or a maximum driver age, and a dry run shows what would be approved. The report of all approvals can be sent by email or provided as a download link.

Common use cases

  • Test the filters first: use the WhatIf parameter to preview which drivers would be approved.

  • Auto-approve all drivers: run without any filter parameter.

  • Approve specific manufacturers: use DriverManufacturer to target vendors such as "Intel" or "AMD".

  • Target specific policies: use PolicyNames or PolicyIds to scope the run to test policies first.

  • Monitor the approvals: configure EmailTo to receive a detailed report after each run.

Parameter interactions

  • Without a policy filter, all driver update policies are processed.

  • Without a driver filter, all pending drivers of the selected policies are approved.

  • PolicyNames and PolicyIds can be combined; both filters apply independently.

  • WhatIf simulates the approvals without making changes, which is useful for testing the filters.

Prerequisites

The driver update endpoints are only available on the Microsoft Graph beta API, which this runbook uses.

Setup regarding email sending

Sending an email report is optional and only happens when a recipient (EmailTo) is provided. The sender address is taken from the RJReport.EmailSender tenant setting.

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.

See the RealmJoin Report Settings documentation for details on all available settings.

Email branding

The report email honors the optional RJReport.Branding.* tenant settings:

  • Header and footer image – public HTTPS URLs, PNG/JPEG/GIF, max. 200 KB each

  • Footer link – target of the footer image

  • Accent and text color – 6-digit hex values, e.g. #0052cc

When these settings are not configured, the default RealmJoin graphics and colors are used. An image that cannot be downloaded or validated, or an invalid color value, never prevents the report email – the corresponding default is used instead.

Setup instructions and image requirements: Email branding.

Location

Organization → Devices → Auto Approve Driver Updates (Scheduled)

Full Runbook name

rjgit-org_devices_auto-approve-driver-updates_scheduled

Details

Property
Value

Version

1.4.0

Required modules

RealmJoin.RunbookHelper (>= 0.8.10) Microsoft.Graph.Authentication (>= 2.41.2) Az.Accounts (>= 5.5.2)

Schedulable

yes

Permissions

Application permissions

  • Type: Microsoft Graph

    • DeviceManagementConfiguration.ReadWrite.All

      • Reads Windows driver update profiles and their inventories and approves pending drivers

    • Mail.Send (optional — feature: Email report)

      • Sends the approval report email via Send-RjReportEmail when EmailTo is configured

    • Organization.Read.All

      • Reads /organization for the tenant display name used in the report email

Parameters

PolicyNames

Only these driver update policies, separated by commas. Leave empty for all policies.

Property
Value

Required

false

Default Value

Type

String

Portal display name

Policy names

PolicyIds

Only these policy IDs, separated by commas. Leave empty for all policies.

Property
Value

Required

false

Default Value

Type

String

Portal display name

Policy IDs

DriverDisplayNamePattern

Only drivers whose name matches this pattern; wildcards such as * are allowed.

Property
Value

Required

false

Default Value

Type

String

Portal display name

Driver name filter

DriverClass

Only these driver classes, separated by commas, for example Bluetooth,Networking,Firmware.

Property
Value

Required

false

Default Value

Type

String

Portal display name

Driver class filter

DriverManufacturer

Only drivers from this manufacturer.

Property
Value

Required

false

Default Value

Type

String

Portal display name

Manufacturer filter

MaximumDriverAge

Only drivers released within this many days, for example 30. Leave empty for any age.

Property
Value

Required

false

Default Value

0

Type

Int32

Portal display name

Maximum driver age (days)

OnlyNeedsReview

Approves only drivers with the status "needs review". Turn off to also re-approve suspended or declined drivers.

Property
Value

Required

false

Default Value

True

Type

Boolean

Portal display name

Only approve drivers needing review?

WhatIf

Only shows which drivers would be approved and sends the report; nothing is approved.

Property
Value

Required

false

Default Value

False

Type

SwitchParameter

Portal display name

Dry run?

ReportFileFormat

Deliver the report as CSV, as an Excel workbook, or both.

Property
Value

Required

false

Default Value

CSV & XLSX

Type

String

Portal display name

Report file format

Portal options

Portal option
Value

CSV & XLSX

CSV & XLSX

CSV only

CSV only

XLSX only

XLSX only

Also upload the report and return a download link that expires after a few days.

Property
Value

Required

false

Default Value

False

Type

Boolean

Portal display name

Create a download link?

Portal options

Portal option
Value

Yes - upload report and return a download link

true

No - do not create a download link

false

ContainerName

Storage container the report files are uploaded to. Set per runbook.

Property
Value

Required

false

Default Value

auto-approve-driver-updates

Type

String

Hidden in portal

yes (preset via runbook customization)

ResourceGroupName

Resource group of the storage account for report uploads. Taken from the tenant setting RJReport.StorageAccount.ResourceGroup.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

StorageAccountName

Storage account for report uploads. Taken from the tenant setting RJReport.StorageAccount.StorageAccountName.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

SubscriptionId

Subscription ID of the storage account for report uploads. Taken from the tenant setting RJReport.StorageAccount.SubscriptionId; the subscription the managed identity signs in to is used when empty.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

LinkExpiryDays

Number of days a download link stays valid. Taken from the tenant setting RJReport.StorageAccount.LinkExpiryDays.

Property
Value

Required

false

Default Value

6

Type

Int32

Hidden in portal

yes (preset via runbook customization)

EmailFrom

Sender address of the report email. Taken from the tenant setting RJReport.EmailSender.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

BrandingHeaderImageUrl

Header image of the report email (HTTPS URL, PNG/JPEG/GIF, max 200 KB). Taken from the tenant setting RJReport.Branding.HeaderImageUrl; the default RealmJoin header is used when empty.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

BrandingFooterImageUrl

Footer image of the report email (HTTPS URL, PNG/JPEG/GIF, max 200 KB). Taken from the tenant setting RJReport.Branding.FooterImageUrl; the default RealmJoin footer is used when empty.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

Link behind the footer image of the report email. Taken from the tenant setting RJReport.Branding.FooterLink; realmjoin.com is used when empty.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

BrandingAccentColor

Accent color of the report email as a 6-digit hex value. Taken from the tenant setting RJReport.Branding.AccentColor; the RealmJoin default is used when empty or invalid.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

BrandingTextColor

Text color of the report email as a 6-digit hex value. Taken from the tenant setting RJReport.Branding.TextColor; the RealmJoin default is used when empty or invalid.

Property
Value

Required

false

Default Value

Type

String

Hidden in portal

yes (preset via runbook customization)

EmailTo

Send the approval report to these addresses, separated by commas. Leave empty to send no email.

Property
Value

Required

false

Default Value

Type

String

Portal display name

Recipient email address(es)

Last updated

Was this helpful?