New-LocalUser

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 lub konto użytkownika lokalnego połączone z kontem Microsoft.

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

PS C:\> 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 lub Password . W związku z tym konto nie wygasa lub domyślnie nie ma hasła.

Przykład 2. Tworzenie konta użytkownika z hasłem

PS C:\> $Password = Read-Host -AsSecureString
PS C:\> New-LocalUser "User03" -Password $Password -FullName "Third User" -Description "Description of this account."
Name    Enabled  Description
----    -------  -----------
User03  True     Description of this account.

Pierwsze polecenie wyświetla monit o hasło przy użyciu Read-Host polecenia cmdlet . Polecenie przechowuje hasło jako bezpieczny ciąg w zmiennej $Password .

Drugie polecenie tworzy konto użytkownika lokalnego przy użyciu hasła przechowywanego 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. Aby uzyskać obiekt DateTime , użyj Get-Date polecenia cmdlet . Jeśli nie określisz tego parametru, konto nie wygaśnie.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-AccountNeverExpires

Wskazuje, że konto nie wygasa.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Description

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-FullName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

Określa nazwę użytkownika dla konta użytkownika.

Jeśli utworzysz konto użytkownika lokalnego dla systemu lokalnego, 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 zawierać tylko krosek . ani spacji.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-NoPassword

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Password

Określa hasło dla konta użytkownika. Możesz użyć Read-Host -AsSecureStringmetody , 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.

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PasswordNeverExpires

Wskazuje, czy hasło wygasa.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-UserMayNotChangePassword

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Wyłączone

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

System.String, System.DateTime, System.Boolean, System.Security.SecureString

Możesz potokować ciąg, obiekt DateTime , wartość logiczną lub bezpieczny ciąg do tego polecenia cmdlet.

Dane wyjściowe

System.Management.Automation.SecurityAccountsManager.LocalUser

To polecenie cmdlet zwraca obiekt LocalUser . Ten obiekt zawiera informacje o koncie użytkownika.

Uwagi

  • Nazwa użytkownika nie może być identyczna z inną nazwą użytkownika lub nazwą grupy na komputerze. Nazwa użytkownika nie może zawierać tylko 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, która opisuje źródło obiektu. Możliwe źródła są następujące:

    • Lokalne
    • Active Directory
    • grupa Azure Active Directory
    • Konto Microsoft

Uwaga

JednostkaSource jest obsługiwana tylko przez Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. We wcześniejszych wersjach właściwość jest pusta.