New-LocalUser
Tworzy konto użytkownika lokalnego.
Składnia
Password (Domyślna)
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>]
Opis
Polecenie cmdlet New-LocalUser tworzy konto użytkownika lokalnego. To polecenie cmdlet tworzy konto użytkownika lokalnego.
Uwaga / Notatka
Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.
Przykłady
Przykład 1. Tworzenie konta użytkownika
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name Enabled Description
---- ------- -----------
User02 True Description of this account.
To polecenie tworzy konto użytkownika lokalnego i nie określa parametrów AccountExpires ani Password. Konto nie wygasa ani nie ma hasła.
Przykład 2. Tworzenie konta użytkownika z hasłem
$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.
Pierwsze polecenie używa polecenia cmdlet Read-Host, aby wyświetlić monit o podanie hasła. Polecenie przechowuje hasło jako bezpieczny ciąg w zmiennej $Password.
Drugie polecenie tworzy konto użytkownika lokalnego i ustawia hasło nowego konta na bezpieczny ciąg przechowywany w $Password. Polecenie określa nazwę użytkownika, pełną nazwę i opis konta użytkownika.
Parametry
-AccountExpires
Określa, kiedy konto użytkownika wygasa. Możesz użyć polecenia cmdlet Get-Date, aby uzyskać obiekt DateTime. Jeśli nie określisz tego parametru, konto nie wygaśnie.
Właściwości parametru
| Typ: | DateTime |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-AccountNeverExpires
Wskazuje, że konto nie wygasa.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Description
Określa komentarz dla konta użytkownika. Maksymalna długość to 48 znaków.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Disabled
Wskazuje, że to polecenie cmdlet tworzy konto użytkownika jako wyłączone.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-FullName
Określa pełną nazwę konta użytkownika. Pełna nazwa różni się od nazwy użytkownika konta użytkownika.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwę użytkownika dla konta użytkownika.
Nazwa użytkownika może zawierać maksymalnie 20 wielkich liter lub małych liter. Nazwa użytkownika nie może zawierać następujących znaków:
", /, , [\]:;|=,+*?<>@
Nazwa użytkownika nie może składać się tylko z krosek . ani spacji.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-NoPassword
Wskazuje, że konto użytkownika nie ma hasła.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
NoPassword
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Password
Określa hasło dla konta użytkownika. Możesz użyć Read-Host -AsSecureString, Get-Credentiallub ConvertTo-SecureString, aby utworzyć obiekt SecureString dla hasła.
Jeśli pominięto parametry Password i NoPassword, New-LocalUser wyświetli monit o podanie hasła nowego użytkownika.
Właściwości parametru
| Typ: | SecureString |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Password
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PasswordNeverExpires
Wskazuje, czy hasło nowego użytkownika wygasa.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Password
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-UserMayNotChangePassword
Wskazuje, że użytkownik nie może zmienić hasła na koncie użytkownika.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
String
Możesz przesłać ciąg do tego polecenia cmdlet.
DateTime
Do tego polecenia cmdlet można przekazać obiekt DateTime.
Boolean
Możesz przekazać wartość logiczną do tego polecenia cmdlet.
SecureString
Możesz przekazać bezpieczny ciąg do tego polecenia cmdlet.
Dane wyjściowe
System.Management.Automation.SecurityAccountsManager.LocalUser
To polecenie cmdlet zwraca obiekt LocalUser reprezentujący utworzone konto użytkownika.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla New-LocalUser:
nlu
Nazwa użytkownika nie może być identyczna z dowolną inną nazwą użytkownika ani nazwą grupy na komputerze. Nazwa użytkownika nie może składać się tylko z krosek . ani spacji. Nazwa użytkownika może zawierać maksymalnie 20 wielkich liter lub małych liter. Nazwa użytkownika nie może zawierać następujących znaków:
", /, , [\]:;|=,+*?<>@
Hasło może zawierać maksymalnie 127 znaków.
Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroupi LocalPrincipal, która opisuje źródło obiektu. Możliwe źródła są następujące:
LocalActive DirectoryAzureADMicrosoftAccount
Uwaga / Notatka
PrincipalSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.
