Set-LocalUser

  • Ссылка
Модуль:
Microsoft.PowerShell.LocalAccounts

Изменяет локальную учетную запись пользователя.

Синтаксис

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

Описание

Командлет Set-LocalUser изменяет локальную учетную запись пользователя. Этот командлет может сбросить пароль локальной учетной записи пользователя.

Примечание.

Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.

Примеры

Пример 1. Изменение описания учетной записи пользователя

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

Эта команда изменяет описание учетной записи пользователя с именем Администратор 07.

Пример 2. Изменение пароля в учетной записи

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

Первая командная строка запрашивает пароль с помощью командлета Read-Host. Команда сохраняет пароль в виде безопасной строки в переменной $Password.

Вторая команда получает учетную запись пользователя с именем User02 с помощью Get-LocalUser. Команда сохраняет учетную запись в переменной $UserAccount.

Третья команда задает новый пароль для учетной записи пользователя, хранящейся в $UserAccount.

Параметры

-AccountExpires

Указывает, когда истекает срок действия учетной записи пользователя. Чтобы получить объект DateTime , используйте Get-Date командлет.

Если срок действия учетной записи не истекает, укажите параметр AccountNeverExpires .

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

-AccountNeverExpires

Указывает, что срок действия учетной записи не истекает.

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Description

Указывает комментарий для учетной записи пользователя. Максимальная длина — 48 символов.

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

-FullName

Указывает полное имя учетной записи пользователя. Полное имя отличается от имени пользователя учетной записи пользователя.

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

-InputObject

Указывает учетную запись пользователя, которая изменяет этот командлет. Чтобы получить учетную запись пользователя, используйте Get-LocalUser командлет.

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

-Name

Указывает имя учетной записи пользователя, которую изменяет этот командлет.

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

-Password

Задает пароль для учетной записи пользователя. Если учетная запись пользователя подключена к учетной записи Майкрософт, не устанавливайте пароль.

Вы можете использовать Read-Host -AsSecureStringили Get-CredentialConvertTo-SecureString создать объект SecureString для пароля.

Если вы опустите параметры password и NoPassword , Set-LocalUser запросит пароль пользователя.

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

-PasswordNeverExpires

Указывает, истекает ли срок действия пароля.

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

-SID

Указывает идентификатор безопасности учетной записи пользователя, которая изменяет этот командлет.

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

-UserMayChangePassword

Указывает, что пользователь может изменить пароль в учетной записи пользователя.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Входные данные

System.Management.Automation.SecurityAccountsManager.LocalUser

Вы можете передать локального пользователя этому командлету.

String

Вы можете передать строку в этот командлет.

SecurityIdentifier

Этот командлет можно передать идентификатор безопасности.

Выходные данные

None

Этот командлет не возвращает выходные данные.

Примечания

Windows PowerShell включает следующие псевдонимы для Set-LocalUser:

  • slu

Свойство PrincipalSource — это свойство для объектов LocalUser, LocalGroup и LocalPrincipal , описывающих источник объекта. Возможные источники:

  • Local
  • Active Directory
  • Группа Microsoft Entra
  • Учетная запись Майкрософт

PrincipalSource поддерживается только windows 10, Windows Server 2016 и более поздними версиями операционной системы Windows. Для более ранних версий свойство пусто.