New-LocalUser
로컬 사용자 계정을 만듭니다.
구문
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
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 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-AccountNeverExpires
계정이 만료되지 않음을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Description
사용자 계정에 대한 주석을 지정합니다. 최대 길이는 48자입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Disabled
이 cmdlet은 사용자 계정을 사용 안 함으로 만듭니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-FullName
사용자 계정의 전체 이름을 지정합니다. 전체 이름은 사용자 계정의 사용자 이름과 다릅니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Name
사용자 계정의 사용자 이름을 지정합니다.
사용자 이름은 최대 20개의 대문자 또는 소문자를 포함할 수 있습니다. 사용자 이름에는 다음 문자가 포함될 수 없습니다.
"
, /
, \
, [
, ]
, :
, ;
, |
, =
, ,
, +
, *
, ?
, <
, >
, @
사용자 이름은 마침표 .
또는 공백으로만 구성할 수 없습니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-NoPassword
사용자 계정에 암호가 없다는 것을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Password
사용자 계정의 암호를 지정합니다.
Read-Host -AsSecureString
, Get-Credential
또는 ConvertTo-SecureString
사용하여 암호에 대한 SecureString 개체를 만들 수 있습니다.
암호 생략하고 NoPassword 매개 변수를 경우 New-LocalUser
새 사용자의 암호를 묻는 메시지를 표시합니다.
형식: | SecureString |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-PasswordNeverExpires
새 사용자의 암호가 만료되는지 여부를 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-UserMayNotChangePassword
사용자가 사용자 계정의 암호를 변경할 수 없다는 것을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | 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 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.
관련 링크
PowerShell