Set-LocalUser

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee wijzigt u een lokaal gebruikersaccount.

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>]

Description

De Set-LocalUser cmdlet wijzigt een lokaal gebruikersaccount. Met deze cmdlet kan het wachtwoord van een lokaal gebruikersaccount opnieuw worden ingesteld.

Notitie

De module Microsoft.PowerShell.LocalAccounts is niet beschikbaar in 32-bits PowerShell op een 64-bits systeem.

Voorbeelden

Voorbeeld 1: Een beschrijving van een gebruikersaccount wijzigen

Set-LocalUser -Name "Admin07" -Description "Description of this account."

Met deze opdracht wijzigt u de beschrijving van een gebruikersaccount met de naam Beheer 07.

Voorbeeld 2: Het wachtwoord voor een account wijzigen

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

Met de eerste opdracht wordt u om een wachtwoord gevraagd met behulp van de cmdlet Read-Host. Met de opdracht wordt het wachtwoord opgeslagen als een beveiligde tekenreeks in de variabele $Password.

Met de tweede opdracht wordt een gebruikersaccount met de naam User02 ophaalt met behulp van Get-LocalUser. Met de opdracht wordt het account opgeslagen in de variabele $UserAccount.

Met de derde opdracht wordt het nieuwe wachtwoord ingesteld voor het gebruikersaccount dat is opgeslagen in $UserAccount.

Parameters

-AccountExpires

Hiermee geeft u op wanneer het gebruikersaccount verloopt. Gebruik de Get-Date cmdlet om een DateTime-object op te halen.

Als u niet wilt dat het account verloopt, geeft u de parameter AccountNeverExpires op.

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

-AccountNeverExpires

Geeft aan dat het account niet verloopt.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Description

Hiermee geeft u een opmerking voor het gebruikersaccount. De maximale lengte is 48 tekens.

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

-FullName

Hiermee geeft u de volledige naam voor het gebruikersaccount. De volledige naam verschilt van de gebruikersnaam van het gebruikersaccount.

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

-InputObject

Hiermee geeft u het gebruikersaccount op dat door deze cmdlet wordt gewijzigd. Gebruik de Get-LocalUser cmdlet om een gebruikersaccount te verkrijgen.

Type:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam op van het gebruikersaccount dat door deze cmdlet wordt gewijzigd.

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

-Password

Hiermee geeft u een wachtwoord voor het gebruikersaccount. Als het gebruikersaccount is verbonden met een Microsoft-account, moet u geen wachtwoord instellen.

U kunt een SecureString-object voor het wachtwoord gebruiken Read-Host -AsSecureStringof Get-CredentialConvertTo-SecureString maken.

Als u de parameters Wachtwoord en NoPassword weglaat, Set-LocalUser wordt u gevraagd om het wachtwoord van de gebruiker.

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

-PasswordNeverExpires

Geeft aan of het wachtwoord verloopt.

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

-SID

Hiermee geeft u de beveiligings-id (SID) van het gebruikersaccount op dat door deze cmdlet wordt gewijzigd.

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

-UserMayChangePassword

Geeft aan dat de gebruiker het wachtwoord voor het gebruikersaccount kan wijzigen.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalUser

U kunt een lokale gebruiker doorsluisen naar deze cmdlet.

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

SecurityIdentifier

U kunt een SID doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Windows PowerShell bevat de volgende aliassen voor Set-LocalUser:

  • slu

De eigenschap PrincipalSource is een eigenschap voor LocalUser-, LocalGroup- en LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

  • Lokaal
  • Active Directory
  • Microsoft Entra-groep
  • Microsoft-account

PrincipalSource wordt alleen ondersteund door Windows 10, Windows Server 2016 en latere versies van het Windows-besturingssysteem. Voor eerdere versies is de eigenschap leeg.