ImportExcel

7.2.0

Public/Read-Clipboard.ps1

function Read-Clipboard {
    <#
        .SYNOPSIS
        Read text from clipboard and pass to either ConvertFrom-Csv or ConvertFrom-Json.
        Check out the how to video - https://youtu.be/dv2GOH5sbpA
 
        .DESCRIPTION
        Read text from clipboard. It can read CSV or JSON. Plus, you can specify the delimiter and headers.
 
        .EXAMPLE
        Read-Clipboard # Detects if the clipboard contains CSV, JSON, or Tab delimited data.
 
        .EXAMPLE
        Read-Clipboard -Delimiter '|' # Converts data using a pipe delimiter
 
        .EXAMPLE
        Read-Clipboard -Header 'P1', 'P2', 'P3' # Specify the header columns to be used
         
    #>
    param(
        $Delimiter,
        $Header   
    )
    
    if ($IsWindows) {
        $osInfo = Get-CimInstance -ClassName Win32_OperatingSystem
        if ($osInfo.ProductType -eq 1) {
            $cvtParams = @{
                Data = Get-Clipboard -Raw
            }
    
            if ($Delimiter) {
                $cvtParams.Delimiter = $Delimiter
            }
    
            if ($Header) {
                $cvtParams.Header = $Header
            }
    
            ReadClipboardImpl @cvtParams
        }
        else {
            Write-Error "This command is only supported on the desktop."
        }
    }
    else {
        Write-Error "This function is only available on Windows desktop"
    }
}

function ReadClipboardImpl {
    param(
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [String] $data,
        $Delimiter,
        $Header
    )

    if (!$PSBoundParameters.ContainsKey('Delimiter') -and !$PSBoundParameters.ContainsKey('Header')) {
        try {
            ConvertFrom-Json $data
        }
        catch {
            if ($data.indexof(",") -gt -1) {
                ConvertFrom-Csv $data
            }
            else {
                ConvertFrom-Csv $data -Delimiter "`t"
            }
        }
    }
    else {
        $cvtParams = @{
            InputObject = $data                 
        }

        if ($Delimiter) {
            $cvtParams.Delimiter = $Delimiter
        }

        if ($Header) {
            $cvtParams.Header = $Header
        }
        
        ConvertFrom-Csv @cvtParams
    }
}