Share via

TenantToTenant-MigratePowerAppEnvironment

Module:
Microsoft.PowerApps.Administration.PowerShell Module

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

Default (Default) 

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.

Parameter properties

Type:String
Default value:2021-04-01
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

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

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

Parameter properties

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

Parameter sets

(All)
Position:4
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.