SharePointCrossTenantMigration.Read.All

Allows the app to read 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.Read.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	f5fa52a5-b9ab-4dc3-885e-9e5b4a67068e	00dcb678-f9af-4e73-acb1-4f1657364629
DisplayText	Read SharePoint Cross-Tenant migration settings and tasks	Read SharePoint Cross-Tenant migration settings and tasks
Description	Allows the app to read your tenant's SharePoint Cross-Tenant migration settings and tasks, without a signed-in user.	Allows the app to read 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
	GET /solutions/sharePoint/migrations/crossOrganizationGroupMappings(sourceGroupObjectId='{sourceGroupObjectId}')
	GET /solutions/sharePoint/migrations/crossOrganizationMigrationTasks/{sharePointMigrationTaskId}
	GET /solutions/sharePoint/migrations/crossOrganizationMigrationTasks/getBySourceGroupMailNickname(sourceGroupMailNickname='{sourceGroupMailNickname}')
	GET /solutions/sharePoint/migrations/crossOrganizationMigrationTasks/getBySourceSiteUrl(sourceSiteUrl='{sourceSiteUrl}')
	GET /solutions/sharePoint/migrations/crossOrganizationMigrationTasks/getBySourceUserPrincipalName(sourcePrincipalName='{sourcePrincipalName}')
	GET /solutions/sharePoint/migrations/crossOrganizationUserMappings(sourceUserPrincipalName='{sourceUserPrincipalName}')

Resources

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

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: 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: 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`.

Table of Contents

SharePointCrossTenantMigration.Read.All

Graph Methods

Resources