CrossTenantContentMigration.ReadWrite.All

Allows the app to read and write your tenant's all cross tenant content migration job details 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 CrossTenantContentMigration.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	c5a29fd1-4629-4f52-8316-4d639ffa95d0	0569b6eb-c9e3-4dc6-a998-6df963be6689
DisplayText	Read and write all cross tenant content migration job details	Read and write all cross tenant content migration job details
Description	Allows the app to read and write your tenant's all cross tenant content migration job details without a signed-in user.	Allows the app to read and write your tenant's all cross tenant content migration job details 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/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
	GET /solutions/migrations/crossTenantMigrationJobs
	GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
	GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users
	GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}
	PATCH /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
	POST /solutions/migrations/crossTenantMigrationJobs
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/cancel
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/migrate
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}/cancel
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/validate

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

	Methods
	DELETE /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
	GET /solutions/migrations/crossTenantMigrationJobs
	GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
	GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users
	GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}
	PATCH /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
	POST /solutions/migrations/crossTenantMigrationJobs
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/cancel
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/migrate
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}/cancel
	POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/validate

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

	Commands
	Get-MgBetaCrossTenantMigrationJob
	Get-MgBetaCrossTenantMigrationJobUser
	Move-MgBetaCrossTenantMigrationJob
	New-MgBetaCrossTenantMigrationJob
	Remove-MgBetaCrossTenantMigrationJob
	Stop-MgBetaCrossTenantMigrationJob
	Stop-MgBetaCrossTenantMigrationJobUser
	Test-MgBetaCrossTenantMigrationJob
	Update-MgBetaCrossTenantMigrationJob

Resources

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

Graph reference: crossTenantMigrationCancelResponse

Property	Type	Description
message	String	The description of the cancellation request.
status	String	The cancellation request status.

Graph reference: crossTenantMigrationJob

Property	Type	Description
completeAfterDateTime	DateTimeOffset	Date and time after which the migration should be performed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is `2024-01-01T00:00:00Z`.
createdBy	String	User principal name (UPN) of the user who created the job. Read-only.
createdDateTime	DateTimeOffset	When the job was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is `2024-01-01T00:00:00Z`. Read-only.
displayName	String	Display name of the job. Must be unique per tenant.
exchangeSettings	exchangeOnlineCrossTenantMigrationSettings	Settings to use for migration of Exchange workload. Nullable.
id	String	Unique identifier for the migration job. Read-only. Inherited from entity.
jobType	crossTenantMigrationJobType	Type of the migration job. The possible values are: `validate` (only validation is performed, no migration), `migrate` (content is migrated), and `unknownFutureValue`.
lastUpdatedDateTime	DateTimeOffset	When this migration job was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is `2024-01-01T00:00:00Z`. Read-only.
message	String	Status message of the migration job. Nullable. Read-only.
resources	String collection	IDs (GUID) of the resources that are migrated with the migration job.
resourceType	String	Type of resource being migrated. Only `Users` is currently supported.
sourceTenantId	String	ID (GUID) of the source tenant for the content migration.
status	crossTenantMigrationJobStatus	Most recent status of the migration job. Read-only. The possible values are: `submitted`, `approved`, `processing`, `cuttingOver`, `inProgress`, `completed`, `completedWithErrors`, `failed`, `cancelled`, `pendingCancel`, `adminActionRequired`, `validateSubmitted`, `validateProcessing`, `validateInProgress`, `validatePassed`, `validateFailed`, `pendingDelete`, `deleted`, `unknownFutureValue`.
targetTenantId	String	ID of the target tenant for the content migration. Read-only.
workloads	String collection	Workloads to migrate. Supported workloads are `Teams`, `Exchange`, and `ODSP` (OneDrive/SharePoint).

Graph reference: crossTenantMigrationServiceStatusDetails

Property	Type	Description
errors	error collection	Errors associated with the migration for this service.
message	String	Service status message.
service	String	Service or workload associated with the status details.
status	crossTenantMigrationServiceStatus	Status of the migration for the service. The possible values are: `notStarted`, `valid`, `invalid`, `error`, `inProgress`, `completed`, `failed`, `cancelled`, `pendingCancel`, `syncing`, `synced`, `finalizing`, `forceComplete`, `unknownFutureValue`.

Graph reference: crossTenantMigrationTask

Property	Type	Description
currentStatus	crossTenantMigrationServiceStatusDetails collection	Most recent status of this migration task.
id	String	ID (GUID) of the resource that's migrated with this task. Inherited from entity.
lastUpdatedDateTime	DateTimeOffset	Date and time when the task was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is `2024-01-01T00:00:00Z`.
taskType	String	Type of migration task. Currently, only `Users` is supported.

Graph reference: exchangeOnlineCrossTenantMigrationSettings

Property	Type	Description
sourceEndpoint	String	Name of the migration endpoint in the source tenant.
targetDeliveryDomain	String	Delivery domain on the target tenant.

Table of Contents

CrossTenantContentMigration.ReadWrite.All

Graph Methods

Resources