functions/Get-JS7IAMAccount.ps1

function Get-JS7IAMAccount
{
<#
.SYNOPSIS
Returns accounts from a JOC Cockpit Identity Service
 
.DESCRIPTION
This cmdlet returns accounts from a JOC Cockpit Identity Service.
 
The following REST Web Service API resources are used:
 
* /iam/accounts
 
.PARAMETER Service
Specifies the unique name of the Identity Service.
 
.PARAMETER Account
Optionally limits the result to the specified user account.
 
.PARAMETER Enabled
Optionally returns enabled accounts only. By default enabled and disabled accounts are returned.
 
.PARAMETER Disabled
Optionally returns disabled accounts only. By default enabled and disabled accounts only are returned.
 
.INPUTS
This cmdlet accepts pipelined input.
 
.OUTPUTS
This cmdlet returns an array of accounts.
 
.EXAMPLE
$accounts = Get-JS7IAMAccount -Service 'JOC'
 
Returns the accounts from the indicated JOC Cockpit Identity Service.
 
.EXAMPLE
$account = Get-JS7IAMAccount -Service 'JOC' -Account 'matt'
 
Returns the given account from the indicated JOC Cockpit Identity Service.
 
.LINK
about_JS7
 
#>

[cmdletbinding()]
param
(
    [Alias('IdentityServiceName')]
    [Parameter(Mandatory=$True,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)]
    [string] $Service,
    [Alias('AccountName')]
    [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)]
    [string] $Account,
    [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)]
    [switch] $Enabled,
    [Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)]
    [switch] $Disabled
)
    Begin
    {
        Approve-JS7Command $MyInvocation.MyCommand
        $stopWatch = Start-JS7StopWatch
    }

    Process
    {
        $body = New-Object PSObject
        Add-Member -Membertype NoteProperty -Name 'identityServiceName' -value $Service -InputObject $body
        Add-Member -Membertype NoteProperty -Name 'enabled' -value ($Enabled -eq $True) -InputObject $body
        Add-Member -Membertype NoteProperty -Name 'disabled' -value ($Disabled -eq $True) -InputObject $body

        if ( $Account )
        {
            Add-Member -Membertype NoteProperty -Name 'accountName' -value $Account -InputObject $body
        }

        [string] $requestBody = $body | ConvertTo-Json -Depth 100
        $response = Invoke-JS7WebRequest -Path '/iam/accounts' -Body $requestBody

        if ( $response.StatusCode -eq 200 )
        {
            $requestResult = ( $response.Content | ConvertFrom-Json )

            if ( !$requestResult )
            {
                throw ( $response | Format-List -Force | Out-String )
            }

            if ( $requestResult.accountItems )
            {
                $requestResult.accountItems
            } else {
                $requestResult
            }
        } else {
            throw ( $response | Format-List -Force | Out-String )
        }

        Write-Verbose ".. $($MyInvocation.MyCommand.Name): account returned"
    }

    End
    {
        Trace-JS7StopWatch -CommandName $MyInvocation.MyCommand.Name -StopWatch $stopWatch
        Update-JS7Session
    }
}