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 New-LocalUser cmdlet tworzy konto użytkownika lokalnego. To polecenie cmdlet tworzy konto użytkownika lokalnego.

Uwaga

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 Read-Host polecenia cmdlet , 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 $Passwordpliku . 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ć Get-Date polecenia cmdlet , 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ć metody Read-Host -AsSecureString, Get-Credentiallub ConvertTo-SecureString , aby utworzyć obiekt SecureString dla hasła.

Jeśli pominięto parametry Password i NoPassword , New-LocalUser zostanie wyświetlony 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 po uruchomieniu polecenia cmdlet. 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 programu 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, LocalGroup i LocalPrincipal obiektów opisujących źródło obiektu. Możliwe źródła są następujące:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Uwaga

JednostkaSource 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.