Skip to content

New Password

github-actions edited this page Aug 20, 2026 · 1 revision

external help file: Secrecy-help.xml Module Name: Secrecy online version: schema: 2.0.0

New-Password

SYNOPSIS

Generates a new random password.

SYNTAX

New-Password [[-Length] <Int32>] [[-Include] <String>] [-AllowedSymbols <String>]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

{{ Fill in the Description }}

EXAMPLES

EXAMPLE 1

New-Password

6x~?sPDKT("hyV5k

PARAMETERS

-Length

The number of characters in the password.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: 16
Accept pipeline input: False
Accept wildcard characters: False

-Include

The required elements to include in the password:

  • Anything: No complexity requirements, use any valid password character.
  • Everything: An uppercase character, a lowercase character, a digit, and a symbol will all be included.
  • Alphanumeric: An uppercase character, a lowercase character, and a digit will all be included, but no symbols.
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: Everything
Accept pipeline input: False
Accept wildcard characters: False

-AllowedSymbols

Which characters are allowed and considered symbols. Space is included by default.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: !"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.String containing the new password.

NOTES

RELATED LINKS

Get-Random