New-LocalUser
Erstellt ein lokales Benutzerkonto.
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>]
Beschreibung
Das Cmdlet erstellt ein lokales New-LocalUser
Benutzerkonto. Mit diesem Cmdlet wird ein lokales Benutzerkonto erstellt.
Hinweis
Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.
Beispiele
Beispiel 1: Erstellen eines Benutzerkontos
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 die Parameter "AccountExpires" oder "Password" nicht an. Das Konto läuft nicht ab oder hat ein Kennwort.
Beispiel 2: Erstellen eines Benutzerkontos mit einem 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 Read-Host
Cmdlet, um Sie zur Eingabe eines Kennworts aufzufordern. Der Befehl speichert das Kennwort als sichere Zeichenfolge in der $Password
Variablen.
Der zweite Befehl erstellt ein lokales Benutzerkonto und legt das Kennwort des neuen Kontos auf die sichere Zeichenfolge fest, in $Password
der gespeichert ist. Der Befehl gibt einen Benutzernamen, vollständigen Namen und eine Beschreibung für das Benutzerkonto an.
Parameter
-AccountExpires
Gibt an, wann das Benutzerkonto abläuft. Sie können das Get-Date
Cmdlet verwenden, um ein DateTime-Objekt abzurufen. Wenn Sie diesen Parameter nicht angeben, läuft das Konto nicht ab.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AccountNeverExpires
Gibt an, dass das Konto nicht abläuft.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Gibt einen Kommentar für das Benutzerkonto an. Die maximale Länge beträgt 48 Zeichen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Disabled
Gibt an, dass dieses Cmdlet das Benutzerkonto als deaktiviert erstellt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FullName
Gibt den vollständigen Namen für das Benutzerkonto an. Der vollständige Name unterscheidet sich vom Benutzernamen des Benutzerkontos.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt den Benutzernamen für das Benutzerkonto an.
Ein Benutzername kann bis zu 20 Groß- oder Kleinbuchstaben enthalten. Ein Benutzername darf nicht die folgenden Zeichen enthalten:
"
, /
, \
, =
+
<
,
?
|
*
>
[
]
:
;
@
Ein Benutzername darf nicht nur aus Zeiträumen .
oder Leerzeichen bestehen.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoPassword
Gibt an, dass das Benutzerkonto kein Kennwort hat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
Gibt ein Kennwort für das Benutzerkonto an. Sie können ein SecureString-Objekt für das Kennwort verwenden Get-Credential
Read-Host -AsSecureString
oder ConvertTo-SecureString
erstellen.
Wenn Sie die Parameter "Password" und "NoPassword " weglassen, werden Sie aufgefordert, New-LocalUser
das Kennwort des neuen Benutzers einzugeben.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PasswordNeverExpires
Gibt an, ob das Kennwort des neuen Benutzers abläuft.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserMayNotChangePassword
Gibt an, dass der Benutzer das Kennwort für das Benutzerkonto nicht ändern kann.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
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.
Ausgaben
System.Management.Automation.SecurityAccountsManager.LocalUser
Dieses Cmdlet gibt ein LocalUser -Objekt zurück, das das erstellte Benutzerkonto darstellt.
Hinweise
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 PrincipalSource-Eigenschaft ist eine Eigenschaft für LocalUser-, LocalGroup- und LocalPrincipal-Objekte , die die Quelle des Objekts beschreiben. Die möglichen Quellen sind wie folgt:
Local
Active Directory
AzureAD
MicrosoftAccount
Hinweis
PrincipalSource wird nur von Windows 10, Windows Server 2016 und höheren Versionen des Windows-Betriebssystems unterstützt. Bei früheren Versionen ist die Eigenschaft leer.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für