Skip to content

Latest commit

 

History

History
101 lines (65 loc) · 2.67 KB

Readme.md

File metadata and controls

101 lines (65 loc) · 2.67 KB
Raw

Password Generator Binary Cmdlet for PowerShell

A fork of the popular PasswordGenerator nuget package used for dotnet projects. The goal of this repository is to port the nuget package to a PowerShell module with similar or exact functionallity, allowing PowerShell module authors and admins to take advantage of a fast and customizable Password Generator.

Usage

Examples:

# By default, all characters available for use and a length of 16

# Will return a random password with the default settings

New-Password
# Same as above but you can set the length. Must be between 4 and 128

# Will return a password which is 32 characters long

New-Password -Length 32
# Same as above but you can set the length. Must be between 4 and 128

# Will return a password which only contains lowercase and uppercase characters and is 21 characters long.

New-Password -IncludeLowercase -IncludeUppercase -Length 21
# You can build up your reqirements by adding parameters, like -IncludeNumeric

# This will return a password which is just numbers and has a default length of 16

New-Password -IncludeNumeric
# As above, here is how to get lower, upper and special characters using this approach

New-Password -IncludeLowercase -IncludeUppercase -IncludeSpecial
# This is the same as the above, but with a length of 128

New-Password -IncludeLowercase -IncludeUppercase -IncludeSpecial -Length 128
# One Time Passwords

# If you want to return a 4 digit number you can use this:

New-Password -IncludeNumeric -Length 4

Example 8

# Returns a 16 length complex password as a System.SecureString object

PS C:\>  New-Password | ConvertTo-SecureString -AsPlainText -Force

Planned Features, up for grabs :)

# Specify your own special characters

# You can specify your own special characters

New-Password -IncludeLowercase -IncludeUppercase -IncludeNumeric -IncludeSpecial "!%¤/:)"

Compatibility

Since the nuget package is based on netstandard2.0, the module currently works on:

  • Newer versions of PowerShell (6+)
  • Older versions of PowerShell (Tested on 5.1)
  • Linux, Mac versions of PowerShell (6+)

ChangeLog

1.0.1

  • Changed verb from 'Get' to 'New'
  • Fixed a bug with IncludeUppercase & IncludeNumeric
  • Fixed Module Auto-Loading

1.0.2

  • Fixed a bug with a certain parameter combination to not output the correct password
  • Refactored the cmdlet
  • Removed DLL from repo and changed the github action to build instead

1.0.3

  • Fixed a bug with module loading due to changes in 1.0.2