Public/Get-PAAccount.ps1

function Get-PAAccount {
    [CmdletBinding()]
    [OutputType('PoshACME.PAAccount')]
    param(
        [Parameter(ParameterSetName='Specific',Position=0,ValueFromPipeline,ValueFromPipelineByPropertyName)]
        [string]$ID,
        [Parameter(ParameterSetName='List',Mandatory)]
        [switch]$List,
        [Parameter(ParameterSetName='List')]
        [ValidateSet('valid','deactivated','revoked')]
        [string]$Status,
        [Parameter(ParameterSetName='List')]
        [string[]]$Contact,
        [Parameter(ParameterSetName='List')]
        [ValidateScript({Test-ValidKeyLength $_ -ThrowOnFail})]
        [Alias('AccountKeyLength')]
        [string[]]$KeyLength,
        [switch]$Refresh,
        [Parameter(ValueFromRemainingArguments=$true)]
        $ExtraParams
    )

    Begin {
        # make sure we have a server configured
        if (!(Get-PAServer)) {
            throw "No ACME server configured. Run Set-PAServer first."
        }

        # make sure the Contact emails have a "mailto:" prefix
        # this may get more complex later if ACME servers support more than email based contacts
        if ($Contact.Count -gt 0) {
            0..($Contact.Count-1) | ForEach-Object {
                if ($Contact[$_] -notlike 'mailto:*') {
                    $Contact[$_] = "mailto:$($Contact[$_])"
                }
            }
        }
    }

    Process {

        # List mode
        if ('List' -eq $PSCmdlet.ParameterSetName) {

            # update from the server first if requested
            if ($Refresh) {
                Write-Debug "Refreshing valid accounts"
                Get-PAAccount -List -Status 'valid' | Update-PAAccount
            }

            # read the contents of each accounts's acct.json
            Write-Debug "Loading PAAccount list from disk"
            $rawFiles = Get-ChildItem "$($script:DirFolder)\*\acct.json" | Get-Content -Raw
            $accts = $rawFiles | ConvertFrom-Json | Sort-Object id | ForEach-Object {

                    # insert the type name and send the results to the pipeline
                    $_.PSObject.TypeNames.Insert(0,'PoshACME.PAAccount')
                    $_
            }

            # filter by Status if specified
            if ('Status' -in $PSBoundParameters.Keys) {
                $accts = $accts | Where-Object { $_.status -eq $Status }
            }

            # filter by KeyLength if specified
            if ('KeyLength' -in $PSBoundParameters.Keys) {
                $accts = $accts | Where-Object { $_.KeyLength -eq $KeyLength }
            }

            # filter by Contact if specified
            if ('Contact' -in $PSBoundParameters.Keys) {
                if (!$Contact) {
                    $accts = $accts | Where-Object { $_.contact -eq $null }
                } else {
                    $accts = $accts | Where-Object { $_.contact -and (Compare-Object $Contact $_.contact) -eq $null }
                }
            }

            return $accts

        # Specific mode
        } else {

            if ($ID) {

                # build the path to acct.json
                $acctFolder = Join-Path $script:DirFolder $ID
                $acctFile = Join-Path $acctFolder 'acct.json'

                # check if it exists
                if (Test-Path $acctFile -PathType Leaf) {
                    Write-Debug "Loading PAAccount from disk"
                    $acct = Get-ChildItem $acctFile | Get-Content -Raw | ConvertFrom-Json
                    $acct.PSObject.TypeNames.Insert(0,'PoshACME.PAAccount')
                } else {
                    throw "Unable to find cached PAAccount info for ID $ID."
                }

            } else {
                # just use the current one
                $acct = $script:Acct
            }

            if ($acct -and $Refresh) {

                # update and then recurse to return the updated data
                Update-PAAccount $acct.id
                return (Get-PAAccount $acct.id)

            } else {
                # just return whatever we've got
                return $acct
            }
        }
    }





    <#
    .SYNOPSIS
        Get ACME account details.
 
    .DESCRIPTION
        Returns details such as Email, key length, and status for one or more ACME accounts previously created.
 
    .PARAMETER ID
        The account id value as returned by the ACME server.
 
    .PARAMETER List
        If specified, the details for all accounts will be returned.
 
    .PARAMETER Status
        A Status string to filter the list of accounts with.
 
    .PARAMETER Contact
        One or more email addresses to filter the list of accounts with. Returned accounts must match exactly (not including the order).
 
    .PARAMETER KeyLength
        The type and size of private key to filter the list of accounts with. For RSA keys, specify a number between 2048-4096 (divisible by 128). For ECC keys, specify either 'ec-256' or 'ec-384'.
 
    .PARAMETER Refresh
        If specified, any account details returned will be freshly queried from the ACME server (excluding deactivated accounts). Otherwise, cached details will be returned.
 
    .PARAMETER ExtraParams
        This parameter can be ignored and is only used to prevent errors when splatting with more parameters than this function supports.
 
    .EXAMPLE
        Get-PAAccount
 
        Get cached ACME account details for the currently selected account.
 
    .EXAMPLE
        Get-PAAccount -ID 1234567
 
        Get cached ACME account details for the specified account ID.
 
    .EXAMPLE
        Get-PAAccount -List
 
        Get all cached ACME account details.
 
    .EXAMPLE
        Get-PAAccount -Refresh
 
        Get fresh ACME account details for the currently selected account.
 
    .EXAMPLE
        Get-PAAccount -List -Refresh
 
        Get fresh ACME account details for all accounts.
 
    .EXAMPLE
        Get-PAAccount -List -Contact user1@example.com
 
        Get cached ACME account details for all accounts that have user1@example.com as the only contact.
 
    .LINK
        Project: https://github.com/rmbolger/Posh-ACME
 
    .LINK
        Set-PAAccount
 
    .LINK
        New-PAAccount
 
    #>

}