New-Password.ps1

# Requires -Module NameIt, Humanizer
function New-Password {
    [CmdletBinding(DefaultParameterSetName = 'Random')]
    param (
        [Parameter(ParameterSetName = 'Random')]
        [switch]
        $Random,

        [Parameter(ParameterSetName = 'Random')]
        [switch]
        $Numbers,

        [Parameter(ParameterSetName = 'Random')]
        [switch]
        $Symbols,

        [Parameter(ParameterSetName = 'Memorable')]
        [switch]
        $Memorable,

        [Parameter(ParameterSetName = 'Memorable')]
        [switch]
        $FullWord,

        [Parameter(ParameterSetName = 'Memorable')]
        [switch]
        $Capitalize,

        [Parameter(Position = 0)]
        [ValidateRange(1, 128)]
        [int]
        $Length,

        [Parameter()]
        [switch]
        $AsSecureString
    )

    if ($Memorable) {
        switch ($Length) {
            { $_ -ge 5 } {
                $Length = 5
                $pattern = $FullWord ? '[verb]-[adjective]-[adjective]-[noun]-[noun]' : '[syllable][syllable]-[syllable][syllable]-[syllable][syllable]-[syllable][syllable]-[syllable][syllable]'
            }
            { $_ -eq 0 -or $_ -eq 3 } {
                $Length = 3
                $pattern = $FullWord ? '[verb]-[adjective]-[noun]' : '[syllable][syllable]-[syllable][syllable]-[syllable][syllable]'
            }
            4 {
                $pattern = $FullWord ? '[verb]-[adjective]-[adjective]-[noun]' : '[syllable][syllable]-[syllable][syllable]-[syllable][syllable]-[syllable][syllable]'
            }
            2 {
                $pattern = $FullWord ? '[adjective]-[noun]' : '[syllable][syllable]-[syllable][syllable]'
            }
            1 {
                $pattern = $FullWord ? '[noun]' : '[syllable][syllable]'
            }
        }

        $string = Invoke-Generate -Template $pattern | ConvertTo-Casing -Case LowerCase

        if ($Capitalize) {
            $parts = $string.Split('-')
            $change = Get-Random -Minimum 0 -Maximum ($parts.Count - 1)
            $parts[$change] = $parts[$change].ToTitleCase()
            $string = $parts -join '-'
        }

    } else {
        $listAlphaLower = 'a'..'z'
        $listAlphaUpper = 'A'..'Z'
        $listNumber = 0..9
        $listSymbol = @('!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '{', '}', '['. ']', ',', '.', '/', '?')

        $charset = $listAlphaLower + $listAlphaUpper
        if ($Numbers) { $charset += $listNumber }
        if ($Symbols) { $charset += $listSymbol }
        if ($Length -eq 0) { $Length = 16 }

        $string = ($charset | Get-Random -Count $Length) -join ''
    }

    If ($AsSecureString) {
        return $string | ConvertTo-SecureString -AsPlainText -Force
    }

    return $string
}