SharePointCrossTenantMigration.Manage.All

Allows the app to read, write and manage your tenant's SharePoint Cross-Tenant migration settings and tasks, 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 SharePointCrossTenantMigration.Manage.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	a0521574-fcd8-4742-b29c-f796df57ea70	c608c170-08b5-466b-a8fe-0b4074b01613
DisplayText	Read, write and manage SharePoint Cross-Tenant migration settings and tasks	Read, write and manage SharePoint Cross-Tenant migration settings and tasks
Description	Allows the app to read, write and manage your tenant's SharePoint Cross-Tenant migration settings and tasks, without a signed-in user.	Allows the app to read, write and manage your tenant's SharePoint Cross-Tenant migration settings and tasks, 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

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

	Methods
	PATCH /solutions/sharePoint/migrations/crossOrganizationGroupMappings
	PATCH /solutions/sharePoint/migrations/crossOrganizationUserMappings
	POST /solutions/sharePoint/migrations/crossOrganizationMigrationTasks
	POST /solutions/sharePoint/migrations/crossOrganizationMigrationTasks/{sharePointMigrationTaskId}/cancel

Resources

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

Graph reference: identity

Property	Type	Description
displayName	String	The display name of the identity. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
id	String	Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
tenantId	String	Unique identity of the tenant. Optional.
thumbnails	thumbnailSet	Keyed collection of thumbnail resources. Optional. Applies to drive items, for example.

Graph reference: sharePointGroupIdentityMapping

Property	Type	Description
groupType	sharePointIdentityMappingGroupType	Indicates the type of group. The possible values are: `none`, `regularGroup`, `m365Group`, `unknownFutureValue`.
id	String	Unique identifier for the group identity mapping. Base64-encoded String. Generated automatically. Inherited from sharePointIdentityMapping.
sourceGroupIdentity	identity	The identity information of the source group in the originating organization. Contains the ID of the source group.
sourceOrganizationId	Guid	The unique identifier of the source organization in the migration. Inherited from sharePointIdentityMapping.
targetGroupIdentity	identity	The identity information of the target group in the destination organization. Contains the ID of the target group.
targetGroupMigrationData	sharePointIdentityMappingGroupMigrationData	Additional migration-specific data for the target group.

Graph reference: sharePointIdentityMapping

Property	Type	Description
id	String	Unique identifier for the identity mapping. Base64-encoded String. Generated automatically. Inherited from entity.
sourceOrganizationId	Guid	The unique identifier of the source organization in the migration.

Graph reference: sharePointIdentityMappingGroupMigrationData

Property	Type	Description
mailNickname	String	The email alias (mail nickname) for the target group in the destination organization.

Property	Type	Description
email	String	The target email address for the user in the destination organization.

Graph reference: sharePointMigrationTask

Property	Type	Description
error	publicError	The error information to provide context for failures. Optional. Read-only. Only on OneDrive and SharePoint.
finishedDateTime	DateTimeOffset	Date and time when the sharePointMigrationTask ended, if available. The task might complete successfully or fail, but it ends at that time. Read-only. Only on OneDrive and SharePoint. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
id	String	The unique ID of the sharePointMigrationTask operation for the source organization and resource defined in the parameters. Omit this property during creation. The service returns it automatically. Inherited from entity.
lastUpdatedDateTime	DateTimeOffset	Date and time when the sharePointMigrationTask was last updated or processed, if available. Use this property to find tasks that stopped processing for a long time. Read-only. Optional. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
parameters	sharePointMigrationTaskParameters	Identifies the source resource and organization, defines the target organization, and includes settings that control the migration process. These settings must be specified during task creation and are also returned in every query about this task for tracking and identification.
startedDateTime	DateTimeOffset	Date and time when the sharePointMigrationTask started, if available. Read-only. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
status	sharePointMigrationTaskStatus	Indicates the status of the migration activity that this task represents. Omit this property during creation. The service returns it automatically. The possible values are: `notStarted`, `inProgress`, `completed`, `cancelled`, `failed`, `unknownFutureValue`.

Graph reference: sharePointMigrationTaskParameters

Property	Type	Description
preferredLatestStartDateTime	DateTimeOffset	The preferred latest start date and time. The system cancels the sharePointMigrationTask if it doesn't start by this time. The value must be greater than the preferredStartDateTime, if present. Optional. Only on OneDrive and SharePoint.
preferredStartDateTime	DateTimeOffset	The preferred start date and time that allows the sharePointMigrationTask to start at a future time instead of as soon as possible (default). Optional. Only on OneDrive and SharePoint.
sourceSiteUrl	String	The SharePoint URL of the source site. Optional. Exactly one of sourceSiteId or sourceUrl must be specified. If both or neither are specified, it's an error. Only on OneDrive and SharePoint.
targetDataLocationCode	String	In Microsoft Entra, this value represents the geographic location (for example, `JPN`, `NAM`) of the target organization where the resource must be migrated to ensure data residency and compliance. This property isn't required for single-geo target organizations or when the migration is to the default GEO of a multi-geo target organization. Optional. Only on OneDrive and SharePoint.
targetOrganizationHost	String	The root, admin, or my site host of the specific multi-geo instance of the target organization where the resource must be migrated to ensure data residency and compliance. This property isn't required for single-geo target organizations or when the migration is to the default GEO of a multi-geo target organization. Optional. Only on OneDrive and SharePoint.
targetOrganizationId	Guid	The unique Microsoft Entra company ID of the target organization to which the source resource must be migrated. Only on OneDrive and SharePoint.
targetSiteUrl	String	The SharePoint URL of the target site. Only on OneDrive and SharePoint.
validateOnly	Boolean	Indicates whether this task is an actual migration or only a validation. If the parameter is missing, the system treats it as `false`. The default behavior is a real migration. Optional. Only on OneDrive and SharePoint.

Graph reference: sharePointUserIdentityMapping

Property	Type	Description
id	String	Unique identifier for the user identity mapping. Base64-encoded String. Generated automatically. Inherited from sharePointIdentityMapping.
sourceOrganizationId	Guid	The unique identifier of the source organization in the migration. Inherited from sharePointIdentityMapping.
sourceUserIdentity	userIdentity	The identity information of the source user in the originating organization. Contains the source user's principal name.
targetUserIdentity	userIdentity	The identity information of the target user in the destination organization. Contains the target user's principal name.
targetUserMigrationData	sharePointIdentityMappingUserMigrationData	Additional migration-specific data for the target user. Contains the email address for the user in the destination organization.
userType	sharePointIdentityMappingUserType	Indicates the type of user. The possible values are: `none`, `regularUser`, `adminUser`, `guestUser`, `unknownFutureValue`.

Graph reference: userIdentity

Property	Type	Description
displayName	String	The display name of the identity. This might not always be available or up-to-date.
id	String	Unique identifier for the identity. Nullable. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
ipAddress	String	Indicates the client IP address associated with the user performing the activity (audit log only).
userPrincipalName	String	The **u

Table of Contents

SharePointCrossTenantMigration.Manage.All

Graph Methods

Resources