Поделиться через


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, описывающим источник объекта. Возможные источники:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Замечание

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