en-US/MG.Passwords.Shell.dll-Help.xml
|
<?xml version="1.0" encoding="utf-8"?> <!-- Help for New-RandomPassword in both editions. Get-Help looks for it by the name of the cmdlet's assembly, and both shell projects build MG.Passwords.Shell.dll, so each copies this file into en-US in its build output, and a release ships it in en-US beside the manifest. Get-Help shows the syntax and the parameters as this file writes them, not as the cmdlet declares them, so a change to a parameter changes this file too. Get-Help prints a line break inside a maml:para as one, so each paragraph stays on one line. It wraps a line of an example's code like a paragraph, so each line of code stays within 76 characters, which fits a console 80 wide. --> <helpItems schema="maml" xmlns="http://msh"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name>New-RandomPassword</command:name> <command:verb>New</command:verb> <command:noun>RandomPassword</command:noun> <maml:description> <maml:para>Generates random passwords of a fixed length or of random lengths within a range.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>The New-RandomPassword cmdlet generates random passwords and returns each one as a string. By default, it generates one password of 8 characters. Use -PasswordLength to set the length of every password and -Count to set how many passwords to generate, or use -MinimumLength and -MaximumLength instead of -PasswordLength to give each password a random length of its own.</maml:para> <maml:para>Passwords are built from groups of characters. By default, the groups are the lowercase letters, the uppercase letters, the digits, and the symbols !@$#%&. Use -CharacterSet to choose groups by name: Lowercase, Uppercase, Digits, and Symbols, or NoLookAlikes, which leaves out characters that are easy to mistake for others, like l and 1, or O and 0. -InputStrings chooses groups by their characters instead. Use -ExtraCharacters to add groups of your own characters, and -OnlyUseExtraCharacters to build passwords from your own characters alone.</maml:para> <maml:para>Every password holds a character from each group, and characters drawn from all the groups together fill the rest of it, where a character that two groups share is as likely as any other. A password with fewer characters than there are groups holds characters from a random choice of the groups instead. Last, the characters are shuffled, so the character from each group can be anywhere in the password.</maml:para> <maml:para>Use -FirstCharacter to start every password with the same character. The character counts toward the length of each password, but it doesn't take the place of any group's character, and it always comes first.</maml:para> <maml:para>Every random choice comes from the operating system's cryptographically secure random number generator.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>New-RandomPassword</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="l, length"> <maml:name>PasswordLength</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Count</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="strings"> <maml:name>InputStrings</maml:name> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="chars, ec"> <maml:name>ExtraCharacters</maml:name> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="onlyec"> <maml:name>OnlyUseExtraCharacters</maml:name> <dev:type> <maml:name>SwitchParameter</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="fc, FirstChar"> <maml:name>FirstCharacter</maml:name> <command:parameterValue required="true" variableLength="false">Char</command:parameterValue> <dev:type> <maml:name>Char</maml:name> </dev:type> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>New-RandomPassword</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="l, length"> <maml:name>PasswordLength</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Count</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>CharacterSet</maml:name> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Lowercase</command:parameterValue> <command:parameterValue required="false" variableLength="false">Uppercase</command:parameterValue> <command:parameterValue required="false" variableLength="false">Digits</command:parameterValue> <command:parameterValue required="false" variableLength="false">Symbols</command:parameterValue> <command:parameterValue required="false" variableLength="false">NoLookAlikes</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">CharacterSet</command:parameterValue> <dev:type> <maml:name>CharacterSet</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="chars, ec"> <maml:name>ExtraCharacters</maml:name> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="onlyec"> <maml:name>OnlyUseExtraCharacters</maml:name> <dev:type> <maml:name>SwitchParameter</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="fc, FirstChar"> <maml:name>FirstCharacter</maml:name> <command:parameterValue required="true" variableLength="false">Char</command:parameterValue> <dev:type> <maml:name>Char</maml:name> </dev:type> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>New-RandomPassword</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Count</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="min, minlength"> <maml:name>MinimumLength</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="max, maxlength"> <maml:name>MaximumLength</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="strings"> <maml:name>InputStrings</maml:name> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="chars, ec"> <maml:name>ExtraCharacters</maml:name> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="onlyec"> <maml:name>OnlyUseExtraCharacters</maml:name> <dev:type> <maml:name>SwitchParameter</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="fc, FirstChar"> <maml:name>FirstCharacter</maml:name> <command:parameterValue required="true" variableLength="false">Char</command:parameterValue> <dev:type> <maml:name>Char</maml:name> </dev:type> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>New-RandomPassword</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Count</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="min, minlength"> <maml:name>MinimumLength</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="max, maxlength"> <maml:name>MaximumLength</maml:name> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>CharacterSet</maml:name> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Lowercase</command:parameterValue> <command:parameterValue required="false" variableLength="false">Uppercase</command:parameterValue> <command:parameterValue required="false" variableLength="false">Digits</command:parameterValue> <command:parameterValue required="false" variableLength="false">Symbols</command:parameterValue> <command:parameterValue required="false" variableLength="false">NoLookAlikes</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">CharacterSet</command:parameterValue> <dev:type> <maml:name>CharacterSet</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="chars, ec"> <maml:name>ExtraCharacters</maml:name> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="onlyec"> <maml:name>OnlyUseExtraCharacters</maml:name> <dev:type> <maml:name>SwitchParameter</maml:name> </dev:type> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="fc, FirstChar"> <maml:name>FirstCharacter</maml:name> <command:parameterValue required="true" variableLength="false">Char</command:parameterValue> <dev:type> <maml:name>Char</maml:name> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="l, length"> <maml:name>PasswordLength</maml:name> <maml:description> <maml:para>Specifies the number of characters in each password, from 1 to 1,048,576. The length includes -FirstCharacter.</maml:para> <maml:para>You can't use -PasswordLength with -MinimumLength and -MaximumLength.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> <dev:defaultValue>8</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Count</maml:name> <maml:description> <maml:para>Specifies the number of passwords to generate, 1 or more.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> <dev:defaultValue>1</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="min, minlength"> <maml:name>MinimumLength</maml:name> <maml:description> <maml:para>Specifies the least number of characters in each password, from 1 to 1,048,575. Each password gets a random length of its own, from -MinimumLength to -MaximumLength, both included. The length includes -FirstCharacter.</maml:para> <maml:para>-MinimumLength and -MaximumLength are used together, and -MinimumLength can't be greater than -MaximumLength.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="max, maxlength"> <maml:name>MaximumLength</maml:name> <maml:description> <maml:para>Specifies the greatest number of characters in each password, from 2 to 1,048,576. It can't be less than -MinimumLength.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="strings"> <maml:name>InputStrings</maml:name> <maml:description> <maml:para>Specifies the groups of characters that passwords are built from, in place of the default groups. Each value has to be one of these strings:</maml:para> <maml:para>- abcdefghijklmnopqrstuvwxyz, the lowercase letters</maml:para> <maml:para>- abcdefghijkmnpqrstuvwxyz, the lowercase letters except l and o</maml:para> <maml:para>- ABCDEFGHIJKLMNOPQRSTUVWXYZ, the uppercase letters</maml:para> <maml:para>- ABCDEFGHJKLMNPQRSTUVWXYZ, the uppercase letters except I and O</maml:para> <maml:para>- 1234567890, the digits</maml:para> <maml:para>- 234567890, the digits except 1</maml:para> <maml:para>- 23456789, the digits except 0 and 1</maml:para> <maml:para>- !@$#%&, six symbols</maml:para> <maml:para>- !#%&, the same symbols except @ and $</maml:para> <maml:para>Without -InputStrings, passwords are built from abcdefghijklmnopqrstuvwxyz, ABCDEFGHIJKLMNOPQRSTUVWXYZ, 1234567890, and !@$#%&, 68 characters in all. The parameter accepts each value regardless of case and uses it as you typed it. A group that's listed twice supplies two characters to every password that has room for them.</maml:para> <maml:para>To leave out characters that are easy to mistake for others, such as l and 1, or O and 0, use the strings that leave them out, or -CharacterSet NoLookAlikes, as in Example 6.</maml:para> <maml:para>You can't use -InputStrings with -CharacterSet. -OnlyUseExtraCharacters leaves out these groups.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> <dev:defaultValue>abcdefghijklmnopqrstuvwxyz, ABCDEFGHIJKLMNOPQRSTUVWXYZ, 1234567890, !@$#%&</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>CharacterSet</maml:name> <maml:description> <maml:para>Specifies groups of characters by name, in place of the default groups. Use one or more of these values:</maml:para> <maml:para>- Lowercase, the lowercase letters, a to z</maml:para> <maml:para>- Uppercase, the uppercase letters, A to Z</maml:para> <maml:para>- Digits, the digits, 0 to 9</maml:para> <maml:para>- Symbols, the symbols !@$#%&</maml:para> <maml:para>- NoLookAlikes, three groups that leave out characters that are easy to mistake for others: the lowercase letters except l and o, the uppercase letters except I and O, and the digits except 0 and 1</maml:para> <maml:para>Every password holds a character from each group when it has room for one, so -CharacterSet Lowercase, Digits gives passwords with at least one lowercase letter and one digit, as in Example 5. NoLookAlikes takes the place of Lowercase, Uppercase, and Digits, so they add nothing beside it, and it combines with Symbols, as in Example 6.</maml:para> <maml:para>You can't use -CharacterSet with -InputStrings. -OnlyUseExtraCharacters leaves out these groups.</maml:para> </maml:description> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Lowercase</command:parameterValue> <command:parameterValue required="false" variableLength="false">Uppercase</command:parameterValue> <command:parameterValue required="false" variableLength="false">Digits</command:parameterValue> <command:parameterValue required="false" variableLength="false">Symbols</command:parameterValue> <command:parameterValue required="false" variableLength="false">NoLookAlikes</command:parameterValue> </command:parameterValueGroup> <command:parameterValue required="true" variableLength="false">CharacterSet</command:parameterValue> <dev:type> <maml:name>CharacterSet</maml:name> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="chars, ec"> <maml:name>ExtraCharacters</maml:name> <maml:description> <maml:para>Specifies more groups of characters to build passwords from, in addition to the default groups, the -CharacterSet groups, or the -InputStrings groups. Every password holds a character from each of these groups too, when it has room for one.</maml:para> <maml:para>A string is one group, and so is a [char] or a [char[]]. Each element of a collection is a group of its own, so -ExtraCharacters 'abc', 'xyz' adds two groups, and -ExtraCharacters (Get-Content -Path .\groups.txt) adds a group for each line of the file. Any other value, such as a number, fails.</maml:para> <maml:para>A group can't be empty, and it can't hold a control character, such as a tab, or a character that takes a surrogate pair, such as an emoji. A character that's listed twice in a group is as likely as the others.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="onlyec"> <maml:name>OnlyUseExtraCharacters</maml:name> <maml:description> <maml:para>Indicates that passwords are built from the -ExtraCharacters groups alone, without the default groups, the -CharacterSet groups, or the -InputStrings groups. The switch requires -ExtraCharacters.</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="fc, FirstChar"> <maml:name>FirstCharacter</maml:name> <maml:description> <maml:para>Specifies the character that every password starts with. The character counts toward the length of each password, so -PasswordLength 1 gives the character alone, but it doesn't take the place of any group's character: the characters after it hold a character from each group, when they have room for one.</maml:para> <maml:para>A number from 0 to 9, as in -FirstCharacter 5, is read as that digit, and other numbers fail. The character can't be a control character, such as a tab, or a character that takes a surrogate pair, such as an emoji.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Char</command:parameterValue> <dev:type> <maml:name>Char</maml:name> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para>You can't pipe objects to New-RandomPassword.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> </dev:type> <maml:description> <maml:para>New-RandomPassword returns each password as a string.</maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>You can also run New-RandomPassword by its alias, rpas.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>---------- Example 1: Generate a password of 12 characters ----------</maml:title> <dev:code>New-RandomPassword -PasswordLength 12 ki%Rjnj4kV7#</dev:code> <dev:remarks> <maml:para>The password holds a character from each default group: at least one lowercase letter, one uppercase letter, one digit, and one symbol.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 2: Generate a password of a random length ----------</maml:title> <dev:code>New-RandomPassword -MinimumLength 6 -MaximumLength 67 2$aGd4K&YKrTy&@kcUJHJ</dev:code> <dev:remarks> <maml:para>The password has from 6 to 67 characters. With -Count, each password gets a random length of its own.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 3: Generate five passwords ----------</maml:title> <dev:code>New-RandomPassword 15 -Count 5 5%A8pjSIX43tRCv b%7!dDLquWrCk@a 5#pd%!30IWQ!$fU 6FS!3kXo@wJ!4ly C2yG#CM1jt1l5v!</dev:code> <dev:remarks> <maml:para>The first positional argument is -PasswordLength, so each of the five passwords has 15 characters.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 4: Start every password with % ----------</maml:title> <dev:code>rpas 68 3 -FirstCharacter % %78P9pqpm7l@PBIfIXpOH$TW1Ev2zM$0VpaG0hF3#g#t7ayKPCYN#R0uRvZFPpYduRMW %qoJ&KqppI6PMIx$2@NtU0&ho6BDOlPd#swckn2p4ZTT$B6Rv8C5qE4LW&W18%pBT#iA %bIbfk3$uco4KpmWfMSpVU!Q#QlokksasyN!2x7VnFng@ycfk2cDovEGedYHAQXfwr7p</dev:code> <dev:remarks> <maml:para>This command uses rpas, the alias of New-RandomPassword. The first positional argument is -PasswordLength and the second is -Count, so the command generates three passwords of 68 characters, and each one starts with %.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 5: Choose groups of characters by name ----------</maml:title> <dev:code>New-RandomPassword 10 -CharacterSet Lowercase, Digits 3yqo5htntn</dev:code> <dev:remarks> <maml:para>-CharacterSet takes the place of the default groups, so the password holds at least one lowercase letter and one digit, and no uppercase letter or symbol.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 6: Leave out characters that look alike ----------</maml:title> <dev:code>New-RandomPassword 16 -CharacterSet NoLookAlikes, Symbols @&Vk7yQJpGdp$RjW</dev:code> <dev:remarks> <maml:para>NoLookAlikes stands for the lowercase letters, the uppercase letters, and the digits without l and o, I and O, and 0 and 1. With Symbols, the password holds a lowercase letter, an uppercase letter, a digit, and a symbol, and none of the characters that are easy to mistake for others. -InputStrings 'abcdefghijkmnpqrstuvwxyz', 'ABCDEFGHJKLMNPQRSTUVWXYZ', '23456789', '!@$#%&' builds passwords from the same groups.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 7: Add a group of your own characters ----------</maml:title> <dev:code>New-RandomPassword -PasswordLength 16 -ExtraCharacters '*+-=?' 9thFXFjq=I=+5m!i</dev:code> <dev:remarks> <maml:para>-ExtraCharacters adds the symbols * + - = and ? as a fifth group, so the password holds at least one of them, besides a character from each default group.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 8: Use only your own characters ----------</maml:title> <dev:code>New-RandomPassword 6 -ExtraCharacters '0123456789' -OnlyUseExtraCharacters 136855</dev:code> <dev:remarks> <maml:para>-OnlyUseExtraCharacters leaves out the default groups, so this command generates a PIN of six digits, all from the one group that -ExtraCharacters adds.</maml:para> <maml:para></maml:para> </dev:remarks> </command:example> </command:examples> </command:command> </helpItems> |