New-LocalUser
Vytvoří místní uživatelský účet.
Syntax
Password (Výchozí)
New-LocalUser
[-Name] <String>
-Password <SecureString>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-PasswordNeverExpires]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NoPassword
New-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-NoPassword]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina New-LocalUser vytvoří místní uživatelský účet. Tato rutina vytvoří místní uživatelský účet.
Poznámka:
Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.
Příklady
Příklad 1: Vytvoření uživatelského účtu
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name Enabled Description
---- ------- -----------
User02 True Description of this account.
Tento příkaz vytvoří místní uživatelský účet a nezadá parametry AccountExpires ani Password. Platnost účtu nevyprší nebo nemá heslo.
Příklad 2: Vytvoření uživatelského účtu s heslem
$Password = Read-Host -AsSecureString
$params = @{
Name = 'User03'
Password = $Password
FullName = 'Third User'
Description = 'Description of this account.'
}
New-LocalUser @params
Name Enabled Description
---- ------- -----------
User03 True Description of this account.
První příkaz použije rutinu Read-Host k zobrazení výzvy k zadání hesla. Příkaz uloží heslo jako zabezpečený řetězec do proměnné $Password.
Druhý příkaz vytvoří místní uživatelský účet a nastaví heslo nového účtu na zabezpečený řetězec uložený v $Password. Příkaz určuje uživatelské jméno, celé jméno a popis uživatelského účtu.
Parametry
-AccountExpires
Určuje, kdy vyprší platnost uživatelského účtu. Pomocí rutiny Get-Date můžete získat objekt DateTime. Pokud tento parametr nezadáte, nevyprší platnost účtu.
Vlastnosti parametru
| Typ: | DateTime |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-AccountNeverExpires
Označuje, že platnost účtu nevyprší.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Description
Určuje komentář pro uživatelský účet. Maximální délka je 48 znaků.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Disabled
Označuje, že tato rutina vytvoří uživatelský účet jako zakázaný.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-FullName
Určuje celé jméno uživatelského účtu. Celé jméno se liší od uživatelského jména uživatelského účtu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje uživatelské jméno pro uživatelský účet.
Uživatelské jméno může obsahovat až 20 velkých nebo malých znaků. Uživatelské jméno nemůže obsahovat následující znaky:
", /, , , ]:*?<[|>;=,+\@
Uživatelské jméno nemůže obsahovat jenom tečky . ani mezery.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-NoPassword
Označuje, že uživatelský účet nemá heslo.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NoPassword
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Password
Určuje heslo pro uživatelský účet. K vytvoření objektu Read-Host -AsSecureString ing pro heslo můžete použít Get-Credential, ConvertTo-SecureStringnebo .
Pokud vynecháte parametry Password a NoPass word, New-LocalUser vás vyzve k zadání hesla nového uživatele.
Vlastnosti parametru
| Typ: | SecureString |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Password
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PasswordNeverExpires
Určuje, jestli vyprší platnost hesla nového uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Password
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-UserMayNotChangePassword
Označuje, že uživatel nemůže změnit heslo uživatelského účtu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Do tohoto příkazletu můžete přesměrovat řetězec.
DateTime
Do této rutiny můžete objekt DateTime.
Boolean
Do této rutiny můžete převést logickou hodnotu.
SecureString
K této rutině můžete připojit zabezpečený řetězec.
Výstupy
System.Management.Automation.SecurityAccountsManager.LocalUser
Tato rutina vrátí objekt LocalUser představující vytvořený uživatelský účet.
Poznámky
Windows PowerShell obsahuje následující aliasy pro New-LocalUser:
nlu
Uživatelské jméno nemůže být identické s žádným jiným uživatelským jménem nebo názvem skupiny v počítači. Uživatelské jméno nemůže obsahovat jenom tečky . ani mezery. Uživatelské jméno může obsahovat až 20 velkých nebo malých znaků. Uživatelské jméno nemůže obsahovat následující znaky:
", /, , , ]:*?<[|>;=,+\@
Heslo může obsahovat až 127 znaků.
Vlastnost PrincipalSource je vlastnost objektů LocalUser, LocalGroupa LocalPrincipal, která popisuje zdroj objektu. Možné zdroje jsou následující:
LocalActive DirectoryAzureADMicrosoftAccount
Poznámka:
principalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.
