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>]
Description
New-LocalUser cmdlet은 로컬 사용자 계정을 만듭니다. 이 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.
첫 번째 명령은 Read-Host cmdlet을 사용하여 암호를 묻는 메시지를 표시합니다. 이 명령은 암호를 $Password 변수에 보안 문자열로 저장합니다.
두 번째 명령은 로컬 사용자 계정을 만들고 새 계정의 암호를 $Password저장된 보안 문자열로 설정합니다. 명령은 사용자 이름, 전체 이름 및 사용자 계정에 대한 설명을 지정합니다.
매개 변수
-AccountExpires
사용자 계정이 만료되는 시기를 지정합니다.
Get-Date cmdlet을 사용하여 DateTime 개체를 가져올 수 있습니다. 이 매개 변수를 지정하지 않으면 계정이 만료되지 않습니다.
매개 변수 속성
| 형식: | 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 |
| 별칭: | cf(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
이 cmdlet은 사용자 계정을 사용 안 함으로 만듭니다.
매개 변수 속성
| 형식: | 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 개체를 만들 수 있습니다.
암호 생략하고 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
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
String
이 cmdlet에 문자열을 파이프할 수 있습니다.
DateTime
DateTime 개체를 이 cmdlet으로 파이프할 수 있습니다.
Boolean
부울 값을 이 cmdlet으로 파이프할 수 있습니다.
SecureString
보안 문자열을 이 cmdlet으로 파이프할 수 있습니다.
출력
System.Management.Automation.SecurityAccountsManager.LocalUser
이 cmdlet은 만든 사용자 계정을 나타내는 LocalUser 개체를 반환합니다.
참고
Windows PowerShell에는 다음과 같은 New-LocalUser의 별칭이 포함되어 있습니다.
nlu
사용자 이름은 컴퓨터의 다른 사용자 이름 또는 그룹 이름과 동일할 수 없습니다. 사용자 이름은 마침표 . 또는 공백으로만 구성할 수 없습니다. 사용자 이름은 최대 20개의 대문자 또는 소문자를 포함할 수 있습니다. 사용자 이름에는 다음 문자가 포함될 수 없습니다.
", /, \, [, ], :, , ;, |, ,=, +*?<>,@
암호는 최대 127자를 포함할 수 있습니다.
PrincipalSource 속성은 LocalUser, LocalGroup, 및 LocalPrincipal 개체의 원본을 설명하는 속성입니다. 가능한 원본은 다음과 같습니다.
LocalActive DirectoryAzureADMicrosoftAccount
비고
PrincipalSource Windows 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.