BackupRestore-Control.ReadWrite.All

Allows the app to update or read the status of M365 backup service (enable/disable), on behalf of the signed in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the BackupRestore-Control.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	fb240865-88f8-4a1d-923f-98dbc7920860	96d46335-d92d-41b8-bc9f-273a692381ea
DisplayText	Update or read the status of the M365 backup service	Update or read the status of the M365 backup service
Description	Allows the app to update or read the status of M365 backup service (enable/disable), without signed in user	Allows the app to update or read the status of M365 backup service (enable/disable), on behalf of the signed in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /solutions/backupRestore/serviceApps/{serviceAppId}
	GET /solutions/backupRestore/serviceApps
	POST /solutions/backupRestore/enable
	POST /solutions/backupRestore/serviceApps
	POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
	POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /solutions/backupRestore/serviceApps/{serviceAppId}
	GET /solutions/backupRestore/serviceApps
	PATCH /solutions/backupRestore/emailNotificationsSetting
	POST /solutions/backupRestore/enable
	POST /solutions/backupRestore/serviceApps
	POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate
	POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Enable-MgSolutionBackupRestore
	Get-MgSolutionBackupRestoreServiceApp
	Initialize-MgSolutionBackupRestoreServiceApp
	Invoke-MgDeactivateSolutionBackupRestoreServiceApp
	New-MgSolutionBackupRestoreServiceApp
	Remove-MgSolutionBackupRestoreServiceApp

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Enable-MgBetaSolutionBackupRestore
	Get-MgBetaSolutionBackupRestoreServiceApp
	Initialize-MgBetaSolutionBackupRestoreServiceApp
	Invoke-MgBetaDeactivateSolutionBackupRestoreServiceApp
	New-MgBetaSolutionBackupRestoreServiceApp
	Remove-MgBetaSolutionBackupRestoreServiceApp

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: backupRestoreRoot

Property	Type	Description
id	String	ID of the Backup Storage service.
serviceStatus	serviceStatus	Represents the tenant-level status of the Backup Storage service.

Graph reference: emailNotificationsSetting

Property	Type	Description
additionalEvents	notificationEventsType	Indicates whether to opt in to additional policy and restore updates. Possible values: `none`, `restoreAndPolicyUpdates`, `unknownFutureValue`.
isEnabled	Boolean	Indicates whether notifications are enabled.
recipients	notificationRecipients	A list of recipients who receive the notifications.

Graph reference: notificationRecipients

Property	Type	Description
customRecipients	emailIdentity collection	A list of users or groups that receive notifications. Only specify this property when role is set to `custom`.
role	notificationRecipientsType	Indicates whether the recipient type is an admin role or a custom list. The possible values are: `none`, `globalAdmins`, `backupAdmins`, `custom`, `allAdmins`, `unknownFutureValue`. The default value is `custom`. This property is read-only for third-party partners.

Graph reference: serviceApp

Property	Type	Description
application	identity	The Entra ID application ID.
effectiveDateTime	DateTimeOffset	Timestamp of the effective activation of the service app.
id	String	The unique identifier of the service app.
lastModifiedBy	identitySet	Identity of the person who last modified the entity.
lastModifiedDateTime	DateTimeOffset	Timestamp of the last modification of the entity.
registrationDateTime	DateTimeOffset	Timestamp of the creation of the service app entity.
status	serviceAppStatus	The status of the service app. This value indicates whether or not the application can be used to control the backup service. The possible values are: `inactive`, `active`, `pendingActive`, `pendingInactive`, `unknownFutureValue`.

Graph reference: serviceStatus

Property	Type	Description
backupServiceConsumer	backupServiceConsumer	The type of consumer. The possible values are: `unknown`, `firstparty`, `thirdparty`, `unknownFutureValue`.
disableReason	disableReason	The reason the service is disabled. The possible values are: `none`, `controllerServiceAppDeleted`, `invalidBillingProfile`, `userRequested`, `unknownFutureValue`.
gracePeriodDateTime	DateTimeOffset	The expiration time of the grace period.
lastModifiedBy	identitySet	Identity of the person who last modified the entity.
lastModifiedDateTime	DateTimeOffset	Timestamp of the last modification of the entity.
restoreAllowedTillDateTime	DateTimeOffset	The expiration time of the restoration allowed period.
status	backupServiceStatus	Status of the service. This value indicates what capabilities can be used. The possible values are: `disabled`, `enabled`, `protectionChangeLocked`, `restoreLocked`, `unknownFutureValue`.

Table of Contents

BackupRestore-Control.ReadWrite.All

Graph Methods

Resources