PowerDataOps

1.0.0.151

src/Types/New-XrmEntityReference.ps1

<#
    .SYNOPSIS
    Initialize EntityReference object instance.

    .DESCRIPTION
    Get new EntityReference object from lookup information.

    .PARAMETER LogicalName
    Table / Entity logical name.

    .PARAMETER Key
    Lookup to alternate key name.

    .PARAMETER Id
    Record Unique identifier.

    .PARAMETER Value
    Key value.
#>
function New-XrmEntityReference {
    [CmdletBinding()]
    [OutputType("Microsoft.Xrm.Sdk.EntityReference")]
    param
    (        
        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $LogicalName,

        [Parameter(Mandatory = $false)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Key,

        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [Alias("Id")]
        [Object]
        $Value
    )
    begin {   
        $StopWatch = [System.Diagnostics.Stopwatch]::StartNew();
        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Start -Parameters ($MyInvocation.MyCommand.Parameters);       
    }    
    process {

        if ($Key) {
            [Microsoft.Xrm.Sdk.EntityReference] (New-Object -TypeName "Microsoft.Xrm.Sdk.EntityReference" -ArgumentList $LogicalName, $Key, $Value);
        }
        else {
            [Microsoft.Xrm.Sdk.EntityReference] (New-Object -TypeName "Microsoft.Xrm.Sdk.EntityReference" -ArgumentList $LogicalName, ([Guid] $Value));
        }        
    }
    end {
        $StopWatch.Stop();
        Trace-XrmFunction -Name $MyInvocation.MyCommand.Name -Stage Stop -StopWatch $StopWatch;
    }    
}

Export-ModuleMember -Function New-XrmEntityReference -Alias *;

Register-ArgumentCompleter -CommandName New-XrmEntityReference -ParameterName "LogicalName" -ScriptBlock {

    param($CommandName, $ParameterName, $WordToComplete, $CommandAst, $FakeBoundParameters)

    $validLogicalNames = Get-XrmEntitiesLogicalName;
    return $validLogicalNames | Where-Object { $_ -like "$wordToComplete*" };
}