PowerDataOps

1.0.0.151

src/Administration/Copy-XrmInstance.ps1

<#
    .SYNOPSIS
    Copy instance to another.

    .DESCRIPTION
    Copy given source instance to target source instance.

    .PARAMETER SourceInstanceDomainName
    Instance domain name (myinstance => myinstance.crm.dynamics1.com) that you want to copy

    .PARAMETER TargetInstanceDomainName
    Instance domain name (myinstance => myinstance.crm.dynamics1.com) that you want to overwrite

    .PARAMETER CopyType
    Copy type : MinimalCopy (schema only) / FullCopy (All)
#>
function Copy-XrmInstance {
    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory, ValueFromPipeline)]
        [String]
        $SourceInstanceDomainName,

        [Parameter(Mandatory = $true)]
        [String]
        $TargetInstanceDomainName,

        [Parameter(Mandatory = $true)]
        [ValidateSet("FullCopy", "MinimalCopy")]
        [String]
        $CopyType
    )
    begin {   
        $StopWatch = [System.Diagnostics.Stopwatch]::StartNew(); 
        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Start -Parameters ($MyInvocation.MyCommand.Parameters); 
        Assert-XrmAdminConnected;
    }    
    process {    
        $sourceInstance = Get-XrmInstance -Name $SourceInstanceDomainName;
        $targetInstance = Get-XrmInstance -Name $TargetInstanceDomainName;

        $copyToRequest = [pscustomobject]@{
            SourceEnvironmentId   = $sourceInstance.Id
            TargetEnvironmentName = $targetInstance.DisplayName
            CopyType              = $CopyType
        }

        $response = Copy-PowerAppEnvironment -EnvironmentName $targetInstance.Id -CopyToRequestDefinition $copyToRequest;
        if ($response.Code -eq 202) {
            $operationStatusUrl = $response.Headers["Operation-Location"];
            Watch-XrmOperation -OperationUrl $operationStatusUrl;
            return;
        }
        
        throw "$($response.Error.code) : $($response.Error.message)";
    }
    end {
        $StopWatch.Stop();
        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Stop -StopWatch $StopWatch;
    }    
}

Export-ModuleMember -Function Copy-XrmInstance -Alias *;