Set-LocalUser

  • Referenz
Modul:
Microsoft.PowerShell.LocalAccounts

Ä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-LocalUservon . 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.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AccountNeverExpires

Gibt an, dass das Konto nicht abläuft.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt einen Kommentar für das Benutzerkonto an. Die maximale Länge beträgt 48 Zeichen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FullName

Gibt den vollständigen Namen für das Benutzerkonto an. Der vollständige Name unterscheidet sich vom Benutzernamen des Benutzerkontos.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt das Benutzerkonto an, das dieses Cmdlet ändert. Verwenden Sie das Get-LocalUser Cmdlet, um ein Benutzerkonto zu erhalten.

Typ:Microsoft.PowerShell.Commands.LocalUser
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Benutzerkontos an, das dieses Cmdlet ändert.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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-CredentialRead-Host -AsSecureStringoder ConvertTo-SecureString erstellen.

Wenn Sie die Parameter "Password" und "NoPassword " weglassen, Set-LocalUser werden Sie zur Eingabe des Kennworts des Benutzers aufgefordert.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PasswordNeverExpires

Gibt an, ob das Kennwort abläuft.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SID

Gibt die Sicherheits-ID (SID) des Benutzerkontos an, das dieses Cmdlet ändert.

Typ:SecurityIdentifier
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UserMayChangePassword

Gibt an, dass der Benutzer das Kennwort für das Benutzerkonto ändern kann.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.Management.Automation.SecurityAccountsManager.LocalUser

Sie können einen lokalen Benutzer an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.

SecurityIdentifier

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.