TenantToTenant-PrepareMigration

Module:

Microsoft.PowerApps.Administration.PowerShell Module

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

Syntax

Default (Default)

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.

Parameter properties

Type:	String
Default value:	2021-04-01
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-EnvironmentName

The target environment ID.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	1
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	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.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	4
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	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.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	3
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-TargetTenantId

The target tenant ID for the migration.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	2
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-WaitUntilFinished

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

Parameter properties

Type:	Boolean
Default value:	False
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.