New-LocalUser

  • Referencia
Modul:
Microsoft.PowerShell.LocalAccounts

Létrehoz egy helyi felhasználói fiókot.

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

A New-LocalUser parancsmag létrehoz egy helyi felhasználói fiókot. Ez a parancsmag létrehoz egy helyi felhasználói fiókot.

Feljegyzés

A Microsoft.PowerShell.LocalAccounts modul nem érhető el a 32 bites PowerShellben egy 64 bites rendszeren.

Példák

1. példa: Felhasználói fiók létrehozása

New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword

Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.

Ez a parancs létrehoz egy helyi felhasználói fiókot, és nem adja meg az AccountExpires vagy a Password paramétereket. A fiók nem jár le vagy jelszóval rendelkezik.

2. példa: Jelszóval rendelkező felhasználói fiók létrehozása

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

Az első parancs a Read-Host parancsmaggal kéri a jelszót. A parancs biztonságos sztringként tárolja a jelszót a $Password változóban.

A második parancs létrehoz egy helyi felhasználói fiókot, és az új fiók jelszavát a benne tárolt biztonságos sztringre állítja $Password. A parancs megadja a felhasználói fiók felhasználónevét, teljes nevét és leírását.

Paraméterek

-AccountExpires

Megadja, hogy mikor jár le a felhasználói fiók. A parancsmaggal Get-Date DateTime-objektumot kérhet le. Ha nem adja meg ezt a paramétert, a fiók nem jár le.

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

-AccountNeverExpires

Azt jelzi, hogy a fiók nem jár le.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Description

A felhasználói fiók megjegyzését adja meg. A maximális hossz 48 karakter.

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

-Disabled

Azt jelzi, hogy ez a parancsmag letiltottként hozza létre a felhasználói fiókot.

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

-FullName

Megadja a felhasználói fiók teljes nevét. A teljes név eltér a felhasználói fiók felhasználónévétől.

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

-Name

Megadja a felhasználói fiók felhasználónevét.

A felhasználónevek legfeljebb 20 nagybetűt vagy kisbetűt tartalmazhatnak. A felhasználónevek nem tartalmazhatják a következő karaktereket:

", /, \, [, ], :;, |, =, ,, +, *, , ?, , <, >,@

A felhasználónevek nem állhatnak csak pontokból . vagy szóközökből.

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

-NoPassword

Azt jelzi, hogy a felhasználói fióknak nincs jelszava.

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

-Password

Megadja a felhasználói fiók jelszavát. Használhatja Read-Host -AsSecureString, Get-Credentialvagy ConvertTo-SecureString létrehozhat egy SecureString objektumot a jelszóhoz.

Ha kihagyja a Jelszó és a NoPassword paramétereket, New-LocalUser kérni fogja az új felhasználó jelszavát.

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

-PasswordNeverExpires

Azt jelzi, hogy az új felhasználó jelszava lejár-e.

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

-UserMayNotChangePassword

Azt jelzi, hogy a felhasználó nem tudja módosítani a jelszót a felhasználói fiókban.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

String

Erre a parancsmagra sztringet csövezhet.

DateTime

Ehhez a parancsmaghoz DateTime-objektumot is csövezhet.

Boolean

Ehhez a parancsmaghoz logikai értéket csövezhet.

SecureString

Erre a parancsmagra biztonságos sztringet csövezhet.

Kimenetek

System.Management.Automation.SecurityAccountsManager.LocalUser

Ez a parancsmag egy LocalUser objektumot ad vissza, amely a létrehozott felhasználói fiókot jelöli.

Jegyzetek

A Windows PowerShell a következő aliasokat New-LocalUsertartalmazza:

  • nlu

A felhasználónév nem lehet azonos a számítógépen található többi felhasználónévvel vagy csoportnévvel. A felhasználónevek nem állhatnak csak pontokból . vagy szóközökből. A felhasználónevek legfeljebb 20 nagybetűt vagy kisbetűt tartalmazhatnak. A felhasználónevek nem tartalmazhatják a következő karaktereket:

", /, \, [, ], :;, |, =, ,, +, *, , ?, , <, >,@

Egy jelszó legfeljebb 127 karaktert tartalmazhat.

A PrincipalSource tulajdonság az objektum forrását leíró LocalUser, LocalGroup és LocalPrincipal objektumok tulajdonsága. A lehetséges források a következők:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Feljegyzés

A PrincipalSource-t csak a Windows 10, a Windows Server 2016 és a Windows operációs rendszer újabb verziói támogatják. A korábbi verziók esetében a tulajdonság üres.