PowerDataOps

1.0.0.120

src/Connection/Import-XrmConnection.ps1

                                <#

    .SYNOPSIS

    Import XrmToolBox connection from file.

    .DESCRIPTION

    Populate XrmToolbox connection object from XML file.

    .PARAMETER Name

    XTB connections file path.

#>

function Import-XrmConnection {

    [CmdletBinding()]

    param

    (

        [Parameter(Mandatory = $true)]

        [String]

        [ValidateScript( { Test-Path $_ })]

        $FilePath

    )

    begin {   

        $StopWatch = [System.Diagnostics.Stopwatch]::StartNew(); 

        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Start -Parameters ($MyInvocation.MyCommand.Parameters); 

    }    

    process {

        $connectionXml = [xml] [IO.File]::ReadAllText($FilePath);

        $connection = New-XrmConnection;

        $connection.Name = $connectionXml.CrmConnections.Name;

        $connection.FilePath = $FilePath;

        $connection.Instances = @();

        foreach ($connectionDetail in $connectionXml.CrmConnections.Connections.ConnectionDetail) {

            $instance = New-XrmInstance;

            $instance.ParentConnection = $connection;

            $instance.Url = $connectionDetail.WebApplicationUrl;

            $instance.Name = $connectionDetail.ConnectionName;

            $instance.UniqueName = $connectionDetail.OrganizationUrlName;

            $instance.ConnectionString = $connectionDetail.ConnectionString;

            $connection.Instances += $instance;

        }

        $connection;

    }

    end {

        $StopWatch.Stop();

        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Stop -StopWatch $StopWatch;

    }    

}

Export-ModuleMember -Function Import-XrmConnection -Alias *;