modules/Get-RandomPassword.ps1
|
<#
.SYNOPSIS Generates a random password with specified length and complexity. .DESCRIPTION This function generates a random password based on the specified length and complexity. The password is a combination of lowercase letters, uppercase letters, numbers, and special characters. The complexity of the password can be controlled using the -Simple switch. If -Simple is specified, the password will only contain lowercase letters, uppercase letters, numbers, and special characters. If -Simple is not specified, the password will contain all characters. .PARAMETER PasswordLength The length of the password to be generated. Default is 10 characters. .PARAMETER Simple A switch to generate a simplified password that contains only lowercase letters, uppercase letters, numbers, and a limited set of special characters. .PARAMETER Count The number of passwords to generate. Default is 1. .EXAMPLE Get-RandomPassword -PasswordLength 12 Generates one complex password of length 12. .EXAMPLE Get-RandomPassword -PasswordLength 12 -Simple Generates one simplified password of length 12. .EXAMPLE Get-RandomPassword -PasswordLength 12 -Count 5 Generates five complex passwords of length 12. .EXAMPLE Get-RandomPassword -PasswordLength 12 -Simple -Count 3 Generates three simplified passwords of length 12. .EXAMPLE Get-RandomPassword -PasswordLength 12 -Count 5 | Set-Clipboard Generates five complex passwords of lenght 12 and copy to clipboard .NOTES Author: Giovanni Solone Credits: https://www.sharepointdiary.com/2020/04/powershell-generate-random-password.html Modification History: - 2025-07-29: Initial version. #> function Get-RandomPassword { param( [Parameter(ValueFromPipeline = $false)] [ValidateRange(1, 256)] [int]$PasswordLength = 10, [switch]$Simple, [int]$Count = 1 ) if ($Simple) { $AllowedSpecialChars = [char[]]'!,.@#$_-' } else { $AllowedSpecialChars = [char[]](33..47 + 58..64 + 91..96 + 123..126) } $CharacterSet = @{ Lowercase = (97..122) | Get-Random -Count 10 | ForEach-Object { [char]$_ } Uppercase = (65..90) | Get-Random -Count 10 | ForEach-Object { [char]$_ } Numeric = (48..57) | Get-Random -Count 10 | ForEach-Object { [char]$_ } SpecialChar = ($AllowedSpecialChars) | Get-Random -Count 10 } $StringSet = $CharacterSet.Uppercase + $CharacterSet.Lowercase + $CharacterSet.Numeric + $CharacterSet.SpecialChar for ($i = 0; $i -lt $Count; $i++) { -join (Get-Random -Count $PasswordLength -InputObject $StringSet) } } |