New-LocalUser
로컬 사용자 계정을 만듭니다.
Syntax
New-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-Name] <String>
-Password <SecureString>
[-PasswordNeverExpires]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-Name] <String>
[-NoPassword]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
cmdlet은 New-LocalUser
로컬 사용자 계정을 만듭니다. 이 cmdlet은 로컬 사용자 계정을 만듭니다.
참고
Microsoft.PowerShell.LocalAccounts 모듈은 64비트 시스템의 32비트 PowerShell에서 사용할 수 없습니다.
예제
예제 1: 사용자 계정 만들기
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name Enabled Description
---- ------- -----------
User02 True Description of this account.
이 명령은 로컬 사용자 계정을 만들고 AccountExpires 또는 암호 매개 변수를 지정하지 않습니다. 계정이 만료되거나 암호가 없습니다.
예제 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.
첫 번째 명령은 cmdlet을 Read-Host
사용하여 암호를 묻는 메시지를 표시합니다. 명령은 암호를 변수에 보안 문자열 $Password
로 저장합니다.
두 번째 명령은 로컬 사용자 계정을 만들고 새 계정의 암호를 에 $Password
저장된 보안 문자열로 설정합니다. 명령은 사용자 계정에 대한 사용자 이름, 전체 이름 및 설명을 지정합니다.
매개 변수
-AccountExpires
사용자 계정이 만료되는 시기를 지정합니다. cmdlet을 Get-Date
사용하여 DateTime 개체를 가져올 수 있습니다. 이 매개 변수를 지정하지 않으면 계정이 만료되지 않습니다.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AccountNeverExpires
계정이 만료되지 않음을 나타냅니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인을 요청합니다.
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: | True |
Accept wildcard characters: | False |
-Disabled
이 cmdlet은 사용자 계정을 사용 안 함으로 만듭니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FullName
사용자 계정의 전체 이름을 지정합니다. 전체 이름은 사용자 계정의 사용자 이름과 다릅니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
사용자 계정의 사용자 이름을 지정합니다.
사용자 이름은 최대 20개의 대문자 또는 소문자를 포함할 수 있습니다. 사용자 이름은 다음 문자를 포함할 수 없습니다.
"
, /
, \
, [
, ]
, :
, ;
, |
, =
, ,
, +
, *
, ?
, <
, >
, @
사용자 이름은 마침표 .
또는 공백으로만 구성할 수 없습니다.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoPassword
사용자 계정에 암호가 없다는 것을 나타냅니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
사용자 계정의 암호를 지정합니다. , Get-Credential
또는 ConvertTo-SecureString
을 사용하여 Read-Host -AsSecureString
암호에 대한 SecureString 개체를 만들 수 있습니다.
암호 및 NoPassword 매개 변수 New-LocalUser
를 생략하면 새 사용자의 암호를 묻는 메시지가 표시됩니다.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PasswordNeverExpires
새 사용자의 암호가 만료되는지 여부를 나타냅니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserMayNotChangePassword
사용자가 사용자 계정의 암호를 변경할 수 없다는 것을 나타냅니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet이 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
문자열을 이 cmdlet에 파이프할 수 있습니다.
DateTime 개체를 이 cmdlet에 파이프할 수 있습니다.
부울 값을 이 cmdlet으로 파이프할 수 있습니다.
이 cmdlet에 보안 문자열을 파이프할 수 있습니다.
출력
System.Management.Automation.SecurityAccountsManager.LocalUser
이 cmdlet은 만든 사용자 계정을 나타내는 LocalUser 개체를 반환합니다.
참고
Windows PowerShell 에 대한 New-LocalUser
다음 별칭을 포함합니다.
nlu
사용자 이름은 컴퓨터의 다른 사용자 이름 또는 그룹 이름과 동일할 수 없습니다. 사용자 이름은 마침표 .
또는 공백으로만 구성할 수 없습니다. 사용자 이름은 최대 20개의 대문자 또는 소문자를 포함할 수 있습니다. 사용자 이름은 다음 문자를 포함할 수 없습니다.
"
, /
, \
, [
, ]
, :
, ;
, |
, =
, ,
, +
, *
, ?
, <
, >
, @
암호는 최대 127자를 포함할 수 있습니다.
PrincipalSource 속성은 개체의 원본을 설명하는 LocalUser, LocalGroup 및 LocalPrincipal 개체의 속성입니다. 가능한 원본은 다음과 같습니다.
Local
Active Directory
AzureAD
MicrosoftAccount
참고
PrincipalSource는 windows 운영 체제의 Windows 10, Windows Server 2016 이상 버전에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.
관련 링크
PowerShell
A cross-platform task automation solution made up of a command-line shell and a scripting language.
피드백
다음에 대한 사용자 의견 제출 및 보기