New-LocalUser

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

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

Das Cmdlet New-LocalUser erstellt ein lokales Benutzerkonto. Mit diesem Cmdlet wird ein lokales Benutzerkonto erstellt.

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

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

Dieser Befehl erstellt ein lokales Benutzerkonto und gibt nicht die Parameter AccountExpires oder Password an. Das Konto läuft nicht ab oder hat ein Kennwort.

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

Der erste Befehl verwendet das cmdlet Read-Host, um Sie zur Eingabe eines Kennworts aufzufordern. Der Befehl speichert das Kennwort als sichere Zeichenfolge in der variablen $Password.

Der zweite Befehl erstellt ein lokales Benutzerkonto und legt das Kennwort des neuen Kontos auf die sichere Zeichenfolge fest, die in $Passwordgespeichert ist. Der Befehl gibt einen Benutzernamen, vollständigen Namen und eine Beschreibung für das Benutzerkonto an.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.

Sie können ein DateTime-Objekt an dieses Cmdlet weiterleiten.

Sie können einen booleschen Wert an dieses Cmdlet weiterleiten.

Sie können eine sichere Zeichenfolge an dieses Cmdlet weiterleiten.

Dieses Cmdlet gibt ein LocalUser--Objekt zurück, das das erstellte Benutzerkonto darstellt.

Windows PowerShell enthält die folgenden Aliase für New-LocalUser:

• nlu

Ein Benutzername kann nicht mit einem anderen Benutzernamen oder Gruppennamen auf dem Computer identisch sein. Ein Benutzername darf nicht nur aus Zeiträumen . oder Leerzeichen bestehen. Ein Benutzername kann bis zu 20 Groß- oder Kleinbuchstaben enthalten. Ein Benutzername darf nicht die folgenden Zeichen enthalten:

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

Ein Kennwort kann bis zu 127 Zeichen enthalten.

Die Eigenschaft PrincipalSource ist eine Eigenschaft für LocalUser, LocalGroupund LocalPrincipal Objekte, die die Quelle des Objekts beschreibt. Die möglichen Quellen sind wie folgt:

• Local
• Active Directory
• AzureAD
• MicrosoftAccount