Set-LocalUser

  • Referencia
Modul:
Microsoft.PowerShell.LocalAccounts

Módosítja a helyi felhasználói fiókot.

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

A Set-LocalUser parancsmag módosít egy helyi felhasználói fiókot. Ez a parancsmag visszaállíthatja egy helyi felhasználói fiók jelszavát.

Feljegyzés

A Microsoft.PowerShell.LocalAccounts modul nem érhető el a 32 bites PowerShellben egy 64 bites rendszeren.

Példák

1. példa: Felhasználói fiók leírásának módosítása

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

Ez a parancs módosítja a Rendszergazda 07 nevű felhasználói fiók leírását.

2. példa: Jelszó módosítása egy fiókon

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

Az első parancssor a Read-Host parancsmag használatával kéri a jelszót. A parancs biztonságos sztringként tárolja a jelszót a $Password változóban.

A második parancs egy User02 nevű felhasználói fiókot kap a használatával Get-LocalUser. A parancs a fiókot a $UserAccount változóban tárolja.

A harmadik parancs beállítja az új jelszót a felhasználói fiókban $UserAccount.

Paraméterek

-AccountExpires

Megadja, hogy mikor jár le a felhasználói fiók. DateTime-objektum beszerzéséhez használja a Get-Date parancsmagot.

Ha nem szeretné, hogy a fiók lejárjon, adja meg az AccountNeverExpires paramétert.

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

-AccountNeverExpires

Azt jelzi, hogy a fiók nem jár le.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Description

A felhasználói fiók megjegyzését adja meg. A maximális hossz 48 karakter.

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

-FullName

Megadja a felhasználói fiók teljes nevét. A teljes név eltér a felhasználói fiók felhasználónévétől.

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

-InputObject

Megadja azt a felhasználói fiókot, amelyet ez a parancsmag módosít. Felhasználói fiók beszerzéséhez használja a Get-LocalUser parancsmagot.

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

-Name

Megadja annak a felhasználói fióknak a nevét, amelyet ez a parancsmag módosít.

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

-Password

Megadja a felhasználói fiók jelszavát. Ha a felhasználói fiók Microsoft-fiókhoz van csatlakoztatva, ne állítson be jelszót.

Használhatja Read-Host -AsSecureString, Get-Credentialvagy ConvertTo-SecureString létrehozhat egy SecureString objektumot a jelszóhoz.

Ha kihagyja a Jelszó és a NoPassword paramétereket, Set-LocalUser kéri a felhasználó jelszavát.

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

-PasswordNeverExpires

Azt jelzi, hogy a jelszó lejár-e.

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

-SID

Megadja annak a felhasználói fióknak a biztonsági azonosítóját (SID), amelyet a parancsmag módosít.

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

-UserMayChangePassword

Azt jelzi, hogy a felhasználó módosíthatja a jelszót a felhasználói fiókban.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

System.Management.Automation.SecurityAccountsManager.LocalUser

Erre a parancsmagra egy helyi felhasználót is be lehet csövezni.

String

Erre a parancsmagra sztringet csövezhet.

SecurityIdentifier

Ehhez a parancsmaghoz egy SID-et is be lehet csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A Windows PowerShell a következő aliasokat Set-LocalUsertartalmazza:

  • slu

A PrincipalSource tulajdonság az objektum forrását leíró LocalUser, LocalGroup és LocalPrincipal objektumok tulajdonsága. A lehetséges források a következők:

  • Helyi
  • Active Directory
  • Microsoft Entra-csoport
  • Microsoft-fiók

A PrincipalSource-t csak a Windows 10, a Windows Server 2016 és a Windows operációs rendszer újabb verziói támogatják. A korábbi verziók esetében a tulajdonság üres.