Checking Endpoint Backup Status in Microsoft Intune Using PowerShell

Question

Checking Endpoint Backup Status in Microsoft Intune Using PowerShell

Swahela Mulla 95

Hello,

I'm looking to use PowerShell to monitor the backup status of endpoints managed with Microsoft Intune and determine the percentage of endpoints with regular and successful backups. For instance, can someone guide me on how to find out what percentage of Intune-managed endpoints have completed a successful backup in the last 30 days?

Any PowerShell script, command, or API recommendations specific to Microsoft Intune would be highly appreciated. If there's any step-by-step documentation available, please provide a reference.

Thank you for your assistance.

Terae E 85 Reputation points

2023-10-17T14:36:36.9733333+00:00
Hello @Swahela Mulla

Here's a general outline of the steps you can follow in order to check your endpoint backup status:

Set Up Your Environment:

Ensure you have PowerShell installed on your machine.

Install the "Intune" module for PowerShell.

Connect to Microsoft Intune:

Use the Connect-MSGraph cmdlet to authenticate and connect to the Microsoft Graph API for Intune.

powershellCopy code Connect-MSGraph

Retrieve Backup Status:

Use the Get-IntuneBackupStatus cmdlet to retrieve backup status information for your Intune-managed devices. You can filter this information to get devices with backups completed in the last 30 days.

powershellCopy code $backupStatus = Get-IntuneBackupStatus -Filter "LastBackupTime ge (Get-Date).AddDays(-30)"

Calculate the Percentage:

Calculate the percentage of devices with successful backups in the last 30 days.

powershellCopy code $totalDevices = $backupStatus.Count $successfulBackups = ($backupStatus | Where-Object { $_.Status -eq 'Success' }).Count $percentageSuccessful = ($successfulBackups / $totalDevices) * 100

Display the Results:

Display the calculated percentage and any other relevant backup information.

powershellCopy code Write-Host "Total Devices: $totalDevices" Write-Host "Devices with Successful Backups in the Last 30 Days: $successfulBackups" Write-Host "Percentage of Devices with Successful Backups: $percentageSuccessful%"

Disconnect from Microsoft Intune (Optional):

After you've retrieved the information, you can disconnect from the Microsoft Graph API if needed.

powershellCopy code Disconnect-MSGraph
Swahela Mulla 95 Reputation points

2023-10-17T15:11:26.94+00:00

Hi Terae E,
I checked (Get-IntuneBackupStatus) this command, but it is not valid, can you please share its document ?

1 answer

Your answer

Terae E 85 Reputation points

2023-10-17T14:36:36.9733333+00:00

Hello @Swahela Mulla

Here's a general outline of the steps you can follow in order to check your endpoint backup status:

Set Up Your Environment:

Ensure you have PowerShell installed on your machine.

Install the "Intune" module for PowerShell.

Connect to Microsoft Intune:

Use the Connect-MSGraph cmdlet to authenticate and connect to the Microsoft Graph API for Intune.

powershellCopy code Connect-MSGraph

Retrieve Backup Status:

Use the Get-IntuneBackupStatus cmdlet to retrieve backup status information for your Intune-managed devices. You can filter this information to get devices with backups completed in the last 30 days.

powershellCopy code $backupStatus = Get-IntuneBackupStatus -Filter "LastBackupTime ge (Get-Date).AddDays(-30)"

Calculate the Percentage:

Calculate the percentage of devices with successful backups in the last 30 days.

powershellCopy code $totalDevices = $backupStatus.Count $successfulBackups = ($backupStatus | Where-Object { $_.Status -eq 'Success' }).Count $percentageSuccessful = ($successfulBackups / $totalDevices) * 100

Display the Results:

Display the calculated percentage and any other relevant backup information.

powershellCopy code Write-Host "Total Devices: $totalDevices" Write-Host "Devices with Successful Backups in the Last 30 Days: $successfulBackups" Write-Host "Percentage of Devices with Successful Backups: $percentageSuccessful%"

Disconnect from Microsoft Intune (Optional):

After you've retrieved the information, you can disconnect from the Microsoft Graph API if needed.

powershellCopy code Disconnect-MSGraph
Swahela Mulla 95 Reputation points

2023-10-17T15:11:26.94+00:00

Hi Terae E,
I checked (Get-IntuneBackupStatus) this command, but it is not valid, can you please share its document ?

Answer 1

@Swahela Mulla,Thanks for posting in Q&A.

From your description, I know that you want to monitor the backup status and the percentage of endpoints successful backups via PowerShell.

For the issue, could you please confirm that if you installed and imported the IntuneBackAndRestore module, if yes, based on my researching, I found that there is not related command to check Intune Backup Status.

We suggest that you ask help for @John Seerden in the link below.

https://github.com/jseerden/IntuneBackupAndRestore

Thanks for your kind understanding.

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Share via

Checking Endpoint Backup Status in Microsoft Intune Using PowerShell

1 answer

Your answer