New-LocalUser

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Vytvoří místní uživatelský účet.

Syntax

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>]

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 pomocí Read-Host rutiny zobrazí výzvu k zadání hesla. Příkaz uloží heslo jako zabezpečený řetězec do $Password proměnné.

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.

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

-AccountNeverExpires

Označuje, že platnost účtu nevyprší.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Description

Určuje komentář pro uživatelský účet. Maximální délka je 48 znaků.

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

-Disabled

Označuje, že tato rutina vytvoří uživatelský účet jako zakázaný.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 se nemůže skládat jenom z tečk . nebo mezer.

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

-NoPassword

Označuje, že uživatelský účet nemá heslo.

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

-Password

Určuje heslo pro uživatelský účet. Můžete použít Read-Host -AsSecureString, Get-Credentialnebo ConvertTo-SecureString vytvořit SecureString objekt pro heslo.

Pokud parametry Password a NoPassword vynecháte, New-LocalUser zobrazí se výzva k zadání hesla nového uživatele.

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

-PasswordNeverExpires

Určuje, jestli vyprší platnost hesla nového uživatele.

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

-UserMayNotChangePassword

Označuje, že uživatel nemůže změnit heslo uživatelského účtu.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

Do této rutiny můžete zamísit řetězec.

DateTime

Do této rutiny můžete přeskakovat 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 se nemůže skládat jenom z tečk . nebo mezer. 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ů.

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují zdroj objektu. Možné zdroje jsou následující:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

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