다음을 통해 공유


New-MsolUser

Azure Active Directory에 사용자를 만듭니다.

구문

New-MsolUser
   [-ImmutableId <String>]
   [-UserPrincipalName <String>]
   [-BlockCredential <Boolean>]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-Fax <String>]
   [-FirstName <String>]
   [-LastName <String>]
   [-LastPasswordChangeTimestamp <DateTime>]
   [-MobilePhone <String>]
   [-Office <String>]
   [-PasswordNeverExpires <Boolean>]
   [-PhoneNumber <String>]
   [-PostalCode <String>]
   [-PreferredDataLocation <String>]
   [-PreferredLanguage <String>]
   [-SoftDeletionTimestamp <DateTime>]
   [-State <String>]
   [-StreetAddress <String>]
   [-StrongPasswordRequired <Boolean>]
   [-Title <String>]
   [-UsageLocation <String>]
   [-AlternateEmailAddresses <String[]>]
   [-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
   [-AlternateMobilePhones <String[]>]
   [-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-UserType <UserType>]
   [-Password <String>]
   [-LicenseOptions <LicenseOption[]>]
   [-ForceChangePassword <Boolean>]
   [-LicenseAssignment <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

New-MsolUser cmdlet은 Azure Active Directory에서 사용자를 만듭니다. 사용자에게 서비스에 대한 액세스 권한을 부여하려면 LicenseAssignment 매개 변수를 사용하여 라이선스를 할당합니다.

예제

예제 1: 사용자 만들기

PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"

이 명령은 사용자를 만듭니다. 사용자에게 할당된 라이선스가 없습니다. 사용자에 대해 임의의 암호가 생성됩니다.

예제 2: 사용자 만들기 및 라이선스 할당

참고

-LicenseAssignment 매개 변수는 더 이상 사용되지 않습니다. Microsoft Graph PowerShell을 사용하여 라이선스를 할당하는 방법을 알아봅니다. 자세한 내용은 라이선스 할당 Microsoft Graph API를 참조하세요.

PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"

이 명령은 새 사용자를 만들고 라이선스를 할당합니다.

예제 3: 사용자 및 기본 설정 데이터 위치 만들기

PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"

이 명령은 사용자 계정 이름이 이고 jdavidchew@contoso.onmicrosoft.com표시 이름이 David이고 기본 설정 데이터 위치가 EUR인 사용자를 만듭니다.

매개 변수

-AlternateEmailAddresses

사용자의 대체 전자 메일 주소를 지정합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-AlternateMobilePhones

사용자의 대체 휴대폰 번호를 지정합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-BlockCredential

사용자가 사용자 ID를 사용하여 로그온할 수 없는지 여부를 지정합니다.

형식:Boolean
Position:Named
Default value:$false
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-City

사용자의 도시를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Country

사용자의 국가 또는 지역을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Department

사용자의 부서를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DisplayName

사용자의 표시 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Fax

사용자의 팩스 번호를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-FirstName

사용자의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ForceChangePassword

사용자가 다음에 로그인할 때 암호를 변경해야 했음을 나타냅니다.

형식:Boolean
Position:Named
Default value:$true
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ImmutableId

사용자의 페더레이션 ID의 변경할 수 없는 ID를 지정합니다. 표준 ID를 가진 사용자에 대해 생략해야 합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LastName

사용자의 성을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LastPasswordChangeTimestamp

암호가 마지막으로 변경된 시간을 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LicenseAssignment

사용자를 할당할 라이선스 배열을 지정합니다.

참고

-LicenseAssignment 매개 변수는 더 이상 사용되지 않습니다. Microsoft Graph PowerShell을 사용하여 라이선스를 할당하는 방법을 알아봅니다. 자세한 내용은 라이선스 할당 Microsoft Graph API를 참조하세요.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LicenseOptions

라이선스 할당 옵션을 지정합니다. SKU 내에서 개별 서비스 계획을 선택적으로 사용하지 않도록 설정하는 데 사용됩니다.

형식:LicenseOption[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MobilePhone

사용자의 휴대폰 번호를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Office

사용자의 사무실을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Password

사용자의 새 암호를 지정합니다. 사용자가 강력한 암호를 사용해야 하도록 설정된 경우에는 다음의 모든 규칙을 충족해야 합니다.

  • 암호에 하나 이상의 소문자를 포함해야 합니다.
  • 암호에는 하나 이상의 대문자를 포함해야 합니다.
  • 암호에는 영숫자 이외의 문자가 하나 이상 포함되어야 합니다.
  • 암호에는 공백, 탭 또는 줄 바꿈이 포함될 수 없습니다.
  • 암호 길이는 8~16자여야 합니다.
  • 암호에 사용자 이름을 포함할 수 없습니다.

이 값을 생략하면 임의의 암호가 사용자에게 할당됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PasswordNeverExpires

사용자 암호가 주기적으로 만료되는지 여부를 지정합니다.

형식:Boolean
Position:Named
Default value:$false
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PhoneNumber

사용자의 전화 번호를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PostalCode

사용자의 우편 번호를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PreferredDataLocation

사용자의 기본 설정 데이터 위치를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PreferredLanguage

사용자의 기본 설정 언어를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SoftDeletionTimestamp

일시 삭제 시간을 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-State

사용자가 있는 주 또는 지방을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StreetAddress

사용자의 거리 주소를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StrongAuthenticationMethods

강력한 인증 방법의 배열을 지정합니다.

형식:StrongAuthenticationMethod[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StrongAuthenticationRequirements

강력한 인증 요구 사항의 배열을 지정합니다.

형식:StrongAuthenticationRequirement[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StrongPasswordRequired

사용자에게 강력한 암호를 요구할지 여부를 지정합니다.

형식:Boolean
Position:Named
Default value:$true
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StsRefreshTokensValidFrom

StsRefreshTokensValidFrom 값을 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Title

사용자의 제목을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-UsageLocation

서비스가 사용되는 사용자의 위치를 지정합니다. 두 글자로 된 국가 또는 지역 코드를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-UserPrincipalName

이 사용자의 사용자 ID를 지정합니다. 이것은 필수입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-UserType

사용자 유형을 지정합니다.

형식:UserType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

출력

Microsoft.Online.Administration.User

이 cmdlet은 임시 암호를 포함하여 생성된 새 사용자에 대한 세부 정보를 반환합니다.