BackupRestore-Configuration.Read.All
Allows the app to read all backup configurations, and lists of Microsoft 365 service resources to be backed-up, without a signed-in user.
Permission Details
Read all backup configuration policies
Allows the app to read all backup configurations, and lists of Microsoft 365 service resources to be backed-up, without a signed-in user.
5fbb5982-3230-4882-93c0-2167523ce0c2
Read backup configuration policies
Allows the app to read the backup configuration, and list of Microsoft 365 service resources to be backed-up, on behalf of the signed in user.
444ed4b6-0554-4dc6-8e9c-3f9a34ee3ff6
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
id |
String |
The unique identifier of the protection rule associated to the policy. |
displayName |
StringNullable |
Name of the policy to be created. |
createdDateTime |
DateTimeOffsetNullable |
The time of creation of the policy. |
createdBy |
identitySet |
The identity of person who created the policy. |
lastModifiedBy |
identitySet |
The identity of the person who last modified the policy. |
lastModifiedDateTime |
DateTimeOffsetNullable |
The timestamp of the last modification of the policy. |
status |
protectionPolicyStatus |
Status of the policy. This value is an aggregated status of the protection units. The possible values are: inactive, activeWithErrors, updating, active, unknownFutureValue. |
isEnabled |
boolean |
|
mailboxInclusionRules |
mailboxProtectionRule collection |
The rules associated with the Exchange protection policy. |
mailboxProtectionUnits |
mailboxProtectionUnit collection |
The protection units (mailboxes) that are protected under the Exchange protection policy. |
mailboxProtectionUnitsBulkAdditionJobs |
mailboxProtectionUnitsBulkAdditionJob collection |
|
protectionPolicyArtifactCount |
object |
|
retentionSettings |
retentionSetting collection |
Contains the retention setting details for the policy. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"@odata.type": "#microsoft.graph.exchangeProtectionPolicy",
"id": "String (identifier)",
"displayName": "String",
"status": "String",
"createdDateTime": "String (timestamp)",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
}
}Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
mailboxInclusionRules |
mailboxProtectionRule collection |
The rules associated with the Exchange protection policy. |
mailboxProtectionUnits |
mailboxProtectionUnit collection |
The protection units (mailboxes) that are protected under the Exchange protection policy. |
mailboxProtectionUnitsBulkAdditionJobs |
mailboxProtectionUnitsBulkAdditionJob collection |
Related mailboxProtectionUnitsBulkAdditionJobs data exposed by this resource. |
retentionSettings |
retentionSetting collection |
Contains the retention setting details for the policy. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.BackupRestore.OneDriveForBusinessProtectionPolicies["{oneDriveForBusinessProtectionPolicy-id}"].DriveProtectionUnitsBulkAdditionJobs["{driveProtectionUnitsBulkAdditionJob-id}"].GetAsync();const options = {
authProvider,
};
const client = Client.init(options);
const driveProtectionUnitsBulkAdditionJob = {
displayName: 'drives-I',
drives: ['[email protected]', '[email protected]', '[email protected]'],
directoryObjectIds: ['1fec4e78-bce4-4aaf-ab1b-5451cc387264']
};
await client.api('/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveProtectionUnitsBulkAdditionJobs')
.post(driveProtectionUnitsBulkAdditionJob);Import-Module Microsoft.Graph.BackupRestore
Get-MgSolutionBackupRestoreOneDriveForBusinessProtectionPolicyDriveProtectionUnitBulkAdditionJob -OneDriveForBusinessProtectionPolicyId $oneDriveForBusinessProtectionPolicyId -DriveProtectionUnitsBulkAdditionJobId $driveProtectionUnitsBulkAdditionJobId# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.solutions.backup_restore.one_drive_for_business_protection_policies.by_one_drive_for_business_protection_policy_id('oneDriveForBusinessProtectionPolicy-id').drive_protection_units_bulk_addition_jobs.by_drive_protection_units_bulk_addition_job_id('driveProtectionUnitsBulkAdditionJob-id').get()App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for BackupRestore-Configuration.Read.All
Grant Admin Consent
Application permissions always require admin consent.