Set-LocalUser
Ändert ein lokales Benutzerkonto.
Syntax
Set-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Name] <String>
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-InputObject] <LocalUser>
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-SID] <SecurityIdentifier>
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Set-LocalUser
Cmdlet ändert ein lokales Benutzerkonto. Dieses Cmdlet kann das Kennwort eines lokalen Benutzerkontos zurücksetzen.
Hinweis
Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.
Beispiele
Beispiel 1: Ändern einer Beschreibung eines Benutzerkontos
Set-LocalUser -Name "Admin07" -Description "Description of this account."
Mit diesem Befehl wird die Beschreibung eines Benutzerkontos namens "Admin07" geändert.
Beispiel 2: Ändern des Kennworts für ein Konto
$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password
Die erste Eingabeaufforderung fordert Sie mithilfe des Cmdlets "Read-Host" auf, ein Kennwort einzugeben. Der Befehl speichert das Kennwort als sichere Zeichenfolge in der variablen $Password.
Der zweite Befehl ruft ein Benutzerkonto mit dem Namen User02 mithilfe Get-LocalUser
von . Der Befehl speichert das Konto in der variablen $UserAccount.
Der dritte Befehl legt das neue Kennwort für das Benutzerkonto fest, in dem gespeichert ist $UserAccount
.
Parameter
-AccountExpires
Gibt an, wann das Benutzerkonto abläuft. Verwenden Sie das Get-Date
Cmdlet, um ein DateTime-Objekt abzurufen.
Wenn das Konto nicht ablaufen soll, geben Sie den Parameter AccountNeverExpires an.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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: | False |
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: | False |
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: | False |
Accept wildcard characters: | False |
-InputObject
Gibt das Benutzerkonto an, das dieses Cmdlet ändert. Verwenden Sie das Get-LocalUser
Cmdlet, um ein Benutzerkonto zu erhalten.
Type: | Microsoft.PowerShell.Commands.LocalUser |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt den Namen des Benutzerkontos an, das dieses Cmdlet ändert.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
Gibt ein Kennwort für das Benutzerkonto an. Wenn das Benutzerkonto mit einem Microsoft-Konto verbunden ist, legen Sie kein Kennwort fest.
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, Set-LocalUser
werden Sie zur Eingabe des Kennworts des Benutzers aufgefordert.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordNeverExpires
Gibt an, ob das Kennwort abläuft.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SID
Gibt die Sicherheits-ID (SID) des Benutzerkontos an, das dieses Cmdlet ändert.
Type: | SecurityIdentifier |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserMayChangePassword
Gibt an, dass der Benutzer das Kennwort für das Benutzerkonto ändern kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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
System.Management.Automation.SecurityAccountsManager.LocalUser
Sie können einen lokalen Benutzer an dieses Cmdlet weiterleiten.
Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.
Sie können eine SID an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Set-LocalUser
:
slu
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:
- Lokal
- Active Directory
- Microsoft Entra Gruppe
- Microsoft-Konto
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