Rename-LocalUser
Переименовывает локальную учетную запись пользователя.
Синтаксис
InputObject
Rename-LocalUser
[-InputObject] <LocalUser>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Rename-LocalUser
[-Name] <String>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Rename-LocalUser
[-NewName] <String>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Rename-LocalUser переименовывает локальную учетную запись пользователя.
Замечание
Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.
Примеры
Пример 1. Переименование учетной записи пользователя
Rename-LocalUser -Name "Admin02" -NewName "AdminContoso02"
Эта команда переименовывает учетную запись пользователя с именем Admin02.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает учетную запись пользователя, которую переименовывает этот командлет. Чтобы получить учетную запись пользователя, используйте командлет Get-LocalUser.
Свойства параметров
| Тип: | Microsoft.PowerShell.Commands.LocalUser |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
InputObject
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя учетной записи пользователя, которую переименовывает этот командлет.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NewName
Задает новое имя учетной записи пользователя.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SID
Указывает идентификатор безопасности учетных записей пользователей, которые переименовывает этот командлет.
Свойства параметров
| Тип: | SecurityIdentifier |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
SecurityIdentifier
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
System.Management.Automation.SecurityAccountsManager.LocalUser
Вы можете передать локального пользователя этому командлету.
String
Вы можете передать строку в этот командлет.
SecurityIdentifier
Этот командлет можно передать идентификатор безопасности.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Rename-LocalUser:
rnlu
Свойство PrincipalSource является свойством объектов LocalUser, LocalGroupи LocalPrincipal, описывающим источник объекта. Возможные источники:
- Локальный
- Active Directory
- Группа Microsoft Entra
- Учетная запись Майкрософт
PrincipalSource поддерживается только в Windows 10, Windows Server 2016 и более поздних версиях операционной системы Windows. Для более ранних версий атрибут пуст.
