New-LocalUser
Создает локальную учетную запись пользователя.
Синтаксис
Password (По умолчанию)
New-LocalUser
[-Name] <String>
-Password <SecureString>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-PasswordNeverExpires]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NoPassword
New-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-NoPassword]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-LocalUser создает локальную учетную запись пользователя. Этот командлет создает локальную учетную запись пользователя.
Замечание
Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.
Примеры
Пример 1. Создание учетной записи пользователя
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name Enabled Description
---- ------- -----------
User02 True Description of this account.
Эта команда создает локальную учетную запись пользователя и не указывает параметры AccountExpires или Password . Срок действия учетной записи не истекает или имеет пароль.
Пример 2. Создание учетной записи пользователя с паролем
$Password = Read-Host -AsSecureString
$params = @{
Name = 'User03'
Password = $Password
FullName = 'Third User'
Description = 'Description of this account.'
}
New-LocalUser @params
Name Enabled Description
---- ------- -----------
User03 True Description of this account.
Первая команда использует Read-Host командлет для запроса пароля. Команда сохраняет пароль в виде безопасной строки в переменной $Password .
Вторая команда создает локальную учетную запись пользователя и задает пароль новой учетной записи для безопасной строки, сохраненной в $Password. Команда указывает имя пользователя, полное имя и описание учетной записи пользователя.
Параметры
-AccountExpires
Указывает, когда истекает срок действия учетной записи пользователя. Для получения объекта DateTime можно использовать Get-Date командлет. Если этот параметр не указан, срок действия учетной записи не истекает.
Свойства параметров
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-AccountNeverExpires
Указывает, что срок действия учетной записи не истекает.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Указывает комментарий для учетной записи пользователя. Максимальная длина — 48 символов.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Disabled
Указывает, что этот командлет создает учетную запись пользователя как отключенную.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-FullName
Указывает полное имя учетной записи пользователя. Полное имя отличается от имени пользователя учетной записи пользователя.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя пользователя для учетной записи пользователя.
Имя пользователя может содержать до 20 символов верхнего регистра или строчных символов. Имя пользователя не может содержать следующие символы:
", /\[]:;|=,+*?<>@
Имя пользователя не может состоять только из периодов или пробелов . .
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NoPassword
Указывает, что у учетной записи пользователя нет пароля.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NoPassword
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Password
Задает пароль для учетной записи пользователя. Вы можете использовать Read-Host -AsSecureString, Get-Credentialили ConvertTo-SecureString для создания объекта SecureString для пароля.
Если вы опустите параметры password и NoPassword , New-LocalUser запросит пароль нового пользователя.
Свойства параметров
| Тип: | SecureString |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Password
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PasswordNeverExpires
Указывает, истекает ли срок действия пароля нового пользователя.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Password
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-UserMayNotChangePassword
Указывает, что пользователь не может изменить пароль в учетной записи пользователя.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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.
Входные данные
String
Вы можете передать строку в этот командлет.
DateTime
Вы можете передать объект DateTime в этот командлет.
Boolean
Логическое значение можно передать этому командлету.
SecureString
Вы можете передать безопасную строку в этот командлет.
Выходные данные
System.Management.Automation.SecurityAccountsManager.LocalUser
Этот командлет возвращает объект LocalUser , представляющий созданную учетную запись пользователя.
Примечания
Windows PowerShell включает следующие псевдонимы для New-LocalUser:
nlu
Имя пользователя не может совпадать с любым другим именем пользователя или именем группы на компьютере. Имя пользователя не может состоять только из периодов или пробелов . . Имя пользователя может содержать до 20 символов верхнего регистра или строчных символов. Имя пользователя не может содержать следующие символы:
", /\[]:;|=,+*?<>@
Пароль может содержать до 127 символов.
Свойство PrincipalSource является свойством объектов LocalUser, LocalGroupи LocalPrincipal, описывающим источник объекта. Возможные источники:
LocalActive DirectoryAzureADMicrosoftAccount
Замечание
PrincipalSource поддерживается только в Windows 10, Windows Server 2016 и более поздних версиях операционной системы Windows. Для более ранних версий атрибут пуст.