New-LocalUser

  • 참조
모듈:
Microsoft.PowerShell.LocalAccounts

로컬 사용자 계정을 만듭니다.

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

사용자 계정의 암호를 지정합니다. 또는 암호에 대한 SecureString 개체를 만들 수 있습니다Read-Host -AsSecureString. Get-CredentialConvertTo-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

입력

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 개체의 속성입니다. 가능한 원본은 다음과 같습니다.

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

참고 항목

PrincipalSource 는 Windows 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.