Partager via


TenantToTenant-PrepareMigration

Validates a tenant to tenant migration of an environment from source to target.

Syntax

TenantToTenant-PrepareMigration
                   [-EnvironmentName] <String>
                   [-TargetTenantId] <String>
                   [-ReadOnlyUserMappingFileContainerUri] <String>
                   [-GuestAdminUserEmail] <String>
                   [[-WaitUntilFinished] <Boolean>]
                   [[-ApiVersion] <String>]
                   [<CommonParameters>]

Description

The TenantToTenant-PrepareMigration function validates the migration of of an environment migration from source to target. Use Get-Help TenantToTenant-PrepareMigration -Examples for more detail.

Examples

EXAMPLE 1

TenantToTenant-PrepareMigration -EnvironmentName 0fc02431-15fb-4563-a5ab-8211beb2a86f -TargetTenantId 26fc7803-4578-4760-as23-f0afb76b84cc -ReadOnlyUserMappingFileContainerUri https://contoso.blob.core.windows.net/readonlyusermappingfilecontainer -GuestAdminUserEmail testuser@testdomain.com -WaitUntilFinished $true

Parameters

-ApiVersion

The API version to call with. Default 2021-04-01.

Type:String
Position:6
Default value:2021-04-01
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnvironmentName

The target environment ID.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-GuestAdminUserEmail

The guest admin user email for the migration. Use for authorizing the user in the target tenant to perform the tenant to tenant migration.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReadOnlyUserMappingFileContainerUri

The ReadOnlyUserMappingFileContainerUri for the migration. Perform GenerateResourceStorage-PowerAppEnvironment to get the container URL for the environment and upload the user mapping file to the path. This URI is the container URI where you have uploaded the user mapping file.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetTenantId

The target tenant ID for the migration.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WaitUntilFinished

If set to true, the function will not return until complete validation of the tenant to tenant migration is complete.

Type:Boolean
Position:5
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False