Auto Approve Driver Updates Scheduled
Approve pending driver updates in Intune driver update policies
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
WhatIfparameter to preview which drivers would be approved.Auto-approve all drivers: run without any filter parameter.
Approve specific manufacturers: use
DriverManufacturerto target vendors such as "Intel" or "AMD".Target specific policies: use
PolicyNamesorPolicyIdsto scope the run to test policies first.Monitor the approvals: configure
EmailToto 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.
PolicyNamesandPolicyIdscan be combined; both filters apply independently.WhatIfsimulates 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
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.
Required
false
Default Value
Type
String
Portal display name
Policy names
PolicyIds
Only these policy IDs, separated by commas. Leave empty for all policies.
Required
false
Default Value
Type
String
Portal display name
Policy IDs
DriverDisplayNamePattern
Only drivers whose name matches this pattern; wildcards such as * are allowed.
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.
Required
false
Default Value
Type
String
Portal display name
Driver class filter
DriverManufacturer
Only drivers from this manufacturer.
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.
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.
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.
Required
false
Default Value
False
Type
SwitchParameter
Portal display name
Dry run?
ReportFileFormat
Deliver the report as CSV, as an Excel workbook, or both.
Required
false
Default Value
CSV & XLSX
Type
String
Portal display name
Report file format
Portal options
CSV & XLSX
CSV & XLSX
CSV only
CSV only
XLSX only
XLSX only
CreateDownloadLink
Also upload the report and return a download link that expires after a few days.
Required
false
Default Value
False
Type
Boolean
Portal display name
Create a download link?
Portal options
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.
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.
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.
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.
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.
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.
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.
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.
Required
false
Default Value
Type
String
Hidden in portal
yes (preset via runbook customization)
BrandingFooterLink
Link behind the footer image of the report email. Taken from the tenant setting RJReport.Branding.FooterLink; realmjoin.com is used when empty.
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.
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.
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.
Required
false
Default Value
Type
String
Portal display name
Recipient email address(es)
Last updated
Was this helpful?