Udostępnij za pośrednictwem

New-LocalUser

  • Odwołanie
Moduł:
Microsoft.PowerShell.LocalAccounts

Tworzy konto użytkownika lokalnego.

Składnia

New-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-Disabled]
   [-FullName <String>]
   [-Name] <String>
   -Password <SecureString>
   [-PasswordNeverExpires]
   [-UserMayNotChangePassword]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-Disabled]
   [-FullName <String>]
   [-Name] <String>
   [-NoPassword]
   [-UserMayNotChangePassword]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-LocalUser tworzy konto użytkownika lokalnego. To polecenie cmdlet tworzy konto użytkownika lokalnego.

Nuta

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.

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AccountNeverExpires

Wskazuje, że konto nie wygasa.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Określa komentarz dla konta użytkownika. Maksymalna długość to 48 znaków.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Disabled

Wskazuje, że to polecenie cmdlet tworzy konto użytkownika jako wyłączone.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-FullName

Określa pełną nazwę konta użytkownika. Pełna nazwa różni się od nazwy użytkownika konta użytkownika.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NoPassword

Wskazuje, że konto użytkownika nie ma hasła.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:SecureString
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PasswordNeverExpires

Wskazuje, czy hasło nowego użytkownika wygasa.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UserMayNotChangePassword

Wskazuje, że użytkownik nie może zmienić hasła na koncie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz przekazać 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ą LocalUser, LocalGroupi obiektów LocalPrincipal opisujących źródło obiektu. Możliwe źródła są następujące:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Nuta

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.