PowerDataOps

1.0.0.128

src/Administration/Add-XrmInstance.ps1

<#
    .SYNOPSIS
    Create new Dataverse instance.
 
    .DESCRIPTION
    Provision new dataverse instance with database.
 
    .PARAMETER InstanceDisplayName
    Instance friendly name
 
    .PARAMETER InstanceDomainName
    Instance domain name for instance url (myinstance => myinstance.crm.dynamics1.com)
 
    .PARAMETER Location
    DataCenter region (France, EMEA, UK, ...)
 
    .PARAMETER Sku
    Instance type (sandbox or production)
 
    .PARAMETER CurrencyCodeName
    Name of currency (EUR, ...)
     
    .PARAMETER LanguageName
    Language name LCID (English = 1033, French = 1036, ...)
#>
function Add-XrmInstance {
    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory)]
        [String]
        $InstanceDisplayName,

        [Parameter(Mandatory)]
        [String]
        $InstanceDomainName,

        [Parameter(Mandatory = $true)]
        [ArgumentCompleter( { Get-XrmRegions })]
        [String]
        $Location,

        [Parameter(Mandatory = $true)]
        [ValidateSet("Sandbox", "Production")]
        [String]
        $Sku,

        [Parameter(Mandatory = $true)]
        [ArgumentCompleter( { Get-AdminPowerAppCdsDatabaseCurrencies })]
        [String]
        $CurrencyCodeName,

        [Parameter(Mandatory = $true)]
        [ArgumentCompleter( { Get-AdminPowerAppCdsDatabaseLanguages  })]
        [String]
        $LanguageName
    )
    begin {   
        $StopWatch = [System.Diagnostics.Stopwatch]::StartNew(); 
        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Start -Parameters ($MyInvocation.MyCommand.Parameters); 
        Assert-XrmAdminConnected;
    }    
    process {    
        $response = New-AdminPowerAppEnvironment -DisplayName $InstanceDisplayName -DomainName $InstanceDomainName -Location $Location -EnvironmentSku $Sku -CurrencyName $CurrencyCodeName -LanguageName $LanguageName -ProvisionDatabase -WaitUntilFinished $true;
        if ($response.Code) {
            throw "$($response.Error.code) : $($response.Error.message)";
        }
        $response;
    }
    end {
        $StopWatch.Stop();
        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Stop -StopWatch $StopWatch;
    }    
}

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