New-RandomPassword.ps1

<#
.SYNOPSIS
    Generates a random Password from the Password state generator API
.DESCRIPTION
    Generates a random Password from the Password state generator API
 
.PARAMETER length
Length for the generated password
 
.PARAMETER includebrackets
If brackets should be included such as {}()
 
.PARAMETER includespecialcharacters
If special characters such as ^_> should be included.
 
.PARAMETER includenumbers
If numbers should be included.
 
.PARAMETER includelowercase
If lowercase characters should be included.
 
.PARAMETER includeuppercase
If uppercase should be included.
 
.PARAMETER Quantity
The quantity of passwords to generate.
 
.EXAMPLE
    PS C:\> New-RandomPassword
 
.EXAMPLE
    New-RandomPassword -length 60 -includenumbers -includeuppercase -includelowercase -includespecialcharacters -includebrackets -Quantity 1
 
.INPUTS
    PasswordGeneratorID - Optional parameter if you want to generate a more or less secure password.
.OUTPUTS
    A string value of the generated password.
.NOTES
    Daryl Newsholme 2019
#>

function New-RandomPassword {
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
        'PSAvoidUsingPlainTextForPassword', '', Justification = 'Not a password just an ID'
    )]
    [CmdletBinding(SupportsShouldProcess = $true)]
    param (
        [parameter(ValueFromPipelineByPropertyName, Position = 0)][int32]$length,
        [parameter(ValueFromPipelineByPropertyName, Position = 1)][switch]$includebrackets,
        [parameter(ValueFromPipelineByPropertyName, Position = 2)][switch]$includespecialcharacters,
        [parameter(ValueFromPipelineByPropertyName, Position = 3)][switch]$includenumbers,
        [parameter(ValueFromPipelineByPropertyName, Position = 4)][switch]$includelowercase,
        [parameter(ValueFromPipelineByPropertyName, Position = 5)][switch]$includeuppercase,
        [parameter(ValueFromPipelineByPropertyName, Position = 6)][string]$excludedcharacters,
        [parameter(ValueFromPipelineByPropertyName, Position = 7)][int32]$Quantity = 1
    )

    begin {
    }

    process {
        if ($PSCmdlet.ShouldProcess("")) {
            if ($PSBoundParameters.Count -lt 1) {
                $output = Get-PasswordStateResource -uri "/api/generatepassword"
            }
            Else {
                if (!$excludedcharacters) {
                    $excludedcharacters = [uri]::EscapeDataString(" *")
                }
                else {
                    $excludedcharacters = [uri]::EscapeDataString(" $excludedcharacters")
                }
                [string]$includebrackets = ([string]$includebrackets).ToLower()
                [string]$includelowercase = ([string]$includelowercase).ToLower()
                [string]$includeuppercase = ([string]$includeuppercase).ToLower()
                [string]$includespecialcharacters = ([string]$includespecialcharacters).ToLower()
                [string]$includenumbers = ([string]$includenumbers).ToLower()

                $uri = "/api/generatepassword/?IncludeAlphaSpecial=true&IncludeWordPhrases=false&minLength=$length&maxLength=$length&lowerCaseChars=$includelowercase&upperCaseChars=$includeuppercase&numericChars=$includenumbers&higherAlphaRatio=true&ambiguousChars=true&specialChars=$includespecialcharacters&specialCharsText=!$%+-_=^&bracketChars=$includebrackets&bracketCharsText={}()&NumberOfWords=0&MaxWordLength=0&PrefixAppend=P&SeparateWords=N&ExcludeChars=$excludedcharacters&GeneratePattern=false&Pattern=null&Qty=$quantity"
                Write-Verbose "[$(Get-Date -format G)] [GET] $uri"
                Get-PasswordStateResource -uri $uri
            }
        }

    }

    end {
        return $output
    }
}