TenantToTenant-MigratePowerAppEnvironment

Performs a tenant to tenant migration of an environment from source to target. Requires running the TenantToTenant-PrepareMigration function to prepare for tenant to tenant migration first to ensure a smooth transition.

Syntax

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

Description

The TenantToTenant-MigratePowerAppEnvironment function migrates an environment from source to target tenant. Use Get-Help TenantToTenant-MigratePowerAppEnvironment -Examples for more detail.

Examples

EXAMPLE 1

TenantToTenant-MigratePowerAppEnvironment -EnvironmentName 0fc02431-15fb-4563-a5ab-8211beb2a86f -TargetTenantId 26fc7803-4578-4760-as23-f0afb76b84cc -GuestAdminUserEmail testuser@testdomain.com -WaitUntilFinished $true

Parameters

-ApiVersion

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

Type:String
Position:5
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.

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 completed.

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