Set-LocalUser

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Modifica un account utente locale.

Sintassi

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

Descrizione

Il Set-LocalUser cmdlet modifica un account utente locale. Questo cmdlet può reimpostare la password di un account utente locale.

Nota

Il modulo Microsoft.PowerShell.LocalAccounts non è disponibile in PowerShell a 32 bit in un sistema a 64 bit.

Esempio

Esempio 1: Modificare una descrizione di un account utente

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

Questo comando modifica la descrizione di un account utente denominato Amministrazione 07.

Esempio 2: Modificare la password in un account

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

Il primo comando richiede una password usando il cmdlet Read-Host. Il comando archivia la password come stringa sicura nella variabile $Password.

Il secondo comando ottiene un account utente denominato User02 usando Get-LocalUser. Il comando archivia l'account nella variabile $UserAccount.

Il terzo comando imposta la nuova password nell'account utente archiviato in $UserAccount.

Parametri

-AccountExpires

Specifica quando l'account utente scade. Per ottenere un oggetto DateTime , utilizzare il Get-Date cmdlet .

Se non si vuole che l'account scada, specificare il parametro AccountNeverExpires .

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

-AccountNeverExpires

Indica che l'account non scade.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-Description

Specifica un commento per l'account utente. La lunghezza massima è di 48 caratteri.

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

-FullName

Specifica il nome completo per l'account utente. Il nome completo è diverso dal nome utente dell'account utente.

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

-InputObject

Specifica l'account utente modificato da questo cmdlet. Per ottenere un account utente, usare il Get-LocalUser cmdlet .

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

-Name

Specifica il nome dell'account utente modificato da questo cmdlet.

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

-Password

Specifica una password per l'account utente. Se l'account utente è connesso a un account Microsoft, non impostare una password.

È possibile usare Read-Host -AsSecureString, Get-Credentialo ConvertTo-SecureString per creare un oggetto SecureString per la password.

Se si omettono i parametri Password e NoPassword , Set-LocalUser viene richiesta la password dell'utente.

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

-PasswordNeverExpires

Indica se la password scade.

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

-SID

Specifica l'ID di sicurezza (SID) dell'account utente modificato da questo cmdlet.

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

-UserMayChangePassword

Indica che l'utente può modificare la password nell'account utente.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

System.Management.Automation.SecurityAccountsManager.LocalUser

È possibile inviare tramite pipe un utente locale a questo cmdlet.

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

SecurityIdentifier

È possibile inviare tramite pipe un SID a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Windows PowerShell include gli alias seguenti per Set-LocalUser:

  • slu

La proprietà PrincipalSource è una proprietà sugli oggetti LocalUser, LocalGroup e LocalPrincipal che descrivono l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Locale
  • Active Directory
  • Gruppo Microsoft Entra
  • Account Microsoft

PrincipalSource è supportato solo da Windows 10, Windows Server 2016 e versioni successive del sistema operativo Windows. Per le versioni precedenti, la proprietà è vuota.