New-AzADUser

구문

WithPassword (기본값)

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -Password <SecureString>
    [-AboutMe <String>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-Birthday <DateTime>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DeviceEnrollmentLimit <Int32>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-HireDate <DateTime>]
    [-Interest <String[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MobilePhone <String>]
    [-MySite <String>]
    [-OfficeLocation <String>]
    [-ImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-PreferredName <String>]
    [-Responsibility <String[]>]
    [-School <String[]>]
    [-ShowInAddressList]
    [-Skill <String[]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-ForceChangePasswordNextLogin]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WithPasswordProfile

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -PasswordProfile <IMicrosoftGraphPasswordProfile>
    [-AboutMe <String>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-Birthday <DateTime>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DeviceEnrollmentLimit <Int32>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-HireDate <DateTime>]
    [-Interest <String[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MobilePhone <String>]
    [-MySite <String>]
    [-OfficeLocation <String>]
    [-ImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-PreferredName <String>]
    [-Responsibility <String[]>]
    [-School <String[]>]
    [-ShowInAddressList]
    [-Skill <String[]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

예제

예제 1: 암호 프로필을 사용하여 사용자 만들기

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

예제 2: 암호를 사용하여 사용자 만들기

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

매개 변수

-AboutMe

사용자가 자신을 설명할 자유형 텍스트 입력 필드입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-AccountEnabled

계정을 사용하도록 설정하기 위한 true입니다. 그렇지 않으면 false입니다.

매개 변수 속성

매개 변수 집합

-AgeGroup

사용자의 연령 그룹을 설정합니다. 허용되는 값: null, minor, notAdult 및 adult. 자세한 내용은 법적 연령 그룹 속성 정의를 참조하세요. $filter 지원합니다(eq, ne, NOT 및 in).

매개 변수 속성

매개 변수 집합

-Birthday

사용자의 생일입니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z가 $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-City

사용자가 있는 구/군/시입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-CompanyName

사용자가 연결된 회사 이름입니다. 이 속성은 외부 사용자가 온 회사를 설명하는 데 유용할 수 있습니다. 회사 이름의 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

매개 변수 집합

-ConsentProvidedForMinor

미성년자에 대한 동의를 얻었는지 여부를 설정합니다. 허용되는 값: null, 허용, 거부 및 notRequired. 자세한 내용은 법적 연령 그룹 속성 정의를 참조하세요. $filter 지원합니다(eq, ne, NOT 및 in).

매개 변수 속성

매개 변수 집합

-Country

사용자가 있는 국가/지역입니다. 예를 들어 미국 또는 영국입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

매개 변수 집합

-DeletedDateTime

.

매개 변수 속성

매개 변수 집합

-Department

사용자가 작동하는 부서의 이름입니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le 및 in 연산자).

매개 변수 속성

매개 변수 집합

-DeviceEnrollmentLimit

사용자가 등록할 수 있는 최대 디바이스 수에 대한 제한입니다. 허용되는 값은 5 또는 1000입니다.

매개 변수 속성

매개 변수 집합

-DisplayName

사용자의 주소록에 표시되는 이름입니다. 이 값은 일반적으로 사용자의 이름, 중간 이니셜 및 성의 조합입니다. 이 속성은 사용자가 생성될 때 필요하며 업데이트 중에는 지울 수 없습니다. 최대 길이는 256자입니다. $filter(eq, ne, NOT, ge, le, in, startsWith), $orderBy 및 $search 지원합니다.

매개 변수 속성

매개 변수 집합

-EmployeeHireDate

사용자가 고용되었거나 향후 고용 시 작업을 시작할 날짜 및 시간입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in).

매개 변수 속성

매개 변수 집합

-EmployeeId

조직에서 사용자에게 할당한 직원 식별자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-EmployeeType

엔터프라이즈 작업자 유형을 캡처합니다. 예를 들어 직원, 계약자, 컨설턴트 또는 공급업체입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-ExternalUserState

초대 API를 사용하여 테넌트에 초대된 외부 사용자의 경우 이 속성은 초대된 사용자의 초대 상태를 나타냅니다. 초대된 사용자의 경우 상태는 PendingAcceptance 또는 Accepted이거나 다른 모든 사용자의 경우 null일 수 있습니다. $filter 지원합니다(eq, ne, NOT, in).

매개 변수 속성

매개 변수 집합

-ExternalUserStateChangeDateTime

externalUserState 속성에 대한 최신 변경 내용에 대한 타임스탬프를 표시합니다. $filter 지원합니다(eq, ne, NOT, in).

매개 변수 속성

매개 변수 집합

-FaxNumber

사용자의 팩스 번호입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-ForceChangePasswordNextLogin

사용자가 다음에 성공한 로그인(true)에서 암호를 변경해야 하는지 지정해야 합니다. 다음에 성공한 로그인에서 암호를 변경하지 않는 기본 동작은 (false)입니다.

매개 변수 속성

매개 변수 집합

-GivenName

사용자의 이름(성 제외)입니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-HireDate

사용자의 고용 날짜입니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다. $select만 반환됩니다. 참고: 이 속성은 SharePoint Online과 관련이 있습니다. 네이티브 employeeHireDate 속성을 사용하여 Microsoft Graph API를 사용하여 고용 날짜 값을 설정하고 업데이트하는 것이 좋습니다.

매개 변수 속성

매개 변수 집합

-ImmutableId

이 속성은 온-프레미스 Active Directory 사용자 계정을 해당 Azure AD 사용자 개체에 연결하는 데 사용됩니다. 사용자의 UPN(userPrincipalName) 속성에 페더레이션된 도메인을 사용하는 경우 Graph에서 새 사용자 계정을 만들 때 이 속성을 지정해야 합니다. 참고: 이 속성을 지정할 때 $ 및 _ 문자를 사용할 수 없습니다. $select만 반환됩니다. $filter 지원합니다(eq, ne, NOT, ge, le, in).

매개 변수 속성

매개 변수 집합

-Interest

사용자의 관심사를 설명하는 목록입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-IsResourceAccount

사용하지 마세요. 나중에 사용할 수 있습니다.

매개 변수 속성

매개 변수 집합

-JobTitle

사용자의 직호입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Mail

사용자의 SMTP 주소(예: admin@contoso.com)입니다. 이 속성을 변경하면 값을 SMTP 주소로 포함하도록 사용자의 proxyAddresses 컬렉션도 업데이트됩니다. 이 속성은 악센트 문자를 포함할 수 있지만, 이 문자를 사용하면 사용자에 대한 다른 Microsoft 애플리케이션에 액세스 문제가 발생할 수 있습니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith, endsWith).

매개 변수 속성

매개 변수 집합

-MailNickname

사용자의 메일 별칭입니다. 이 속성은 사용자를 만들 때 지정해야 합니다. 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-MobilePhone

사용자의 기본 셀룰러 전화 번호입니다. 온-프레미스 디렉터리에서 동기화된 사용자에 대한 읽기 전용입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-MySite

사용자의 개인 사이트에 대한 URL입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-OfficeLocation

사용자의 비즈니스 위치에 있는 사무실 위치입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-OtherMail

사용자의 추가 전자 메일 주소 목록입니다. 예: [''bob@contoso.com, 'Robert@fabrikam.com']. 참고: 이 속성에는 악센트 문자를 포함할 수 있지만 사용자의 자사 애플리케이션에 대한 액세스 문제가 발생할 수 있습니다. $filter 지원합니다(eq, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Password

사용자에 대한 암호입니다. 테넌트의 암호 복잡성 요구 사항을 충족해야 합니다. 강력한 암호를 설정하는 것이 좋습니다.

매개 변수 속성

매개 변수 집합

-PasswordPolicy

사용자에 대한 암호 정책을 지정합니다. 이 값은 기본 정책보다 약한 암호를 지정할 수 있는 DisableStrongPassword 값이 하나 있는 열거형입니다. DisablePasswordExpiration도 지정할 수 있습니다. 두 가지를 함께 지정할 수 있습니다. 예: DisablePasswordExpiration, DisableStrongPassword.Supports $filter(ne, NOT).

매개 변수 속성

매개 변수 집합

-PasswordProfile

passwordProfile 생성하려면 PASSWORDPROFILE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

매개 변수 속성

매개 변수 집합

-PostalCode

사용자의 우편 주소에 대한 우편 번호입니다. 우편 번호는 사용자의 국가/지역과 관련이 있습니다. 미국에서는 이 특성에 우편 번호가 포함됩니다. 최대 길이는 40자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-PreferredLanguage

사용자의 기본 설정 언어입니다. ISO 639-1 코드를 따라야 합니다. 예를 들면 en-US입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-PreferredName

사용자의 기본 설정 이름입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-Responsibility

사용자가 자신의 책임을 열거할 목록입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-School

사용자가 참석한 학교를 열거할 목록입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-ShowInAddressList

Outlook 전역 주소 목록에 이 사용자가 포함되어야 하면 true이고, 그렇지 않으면 false입니다. 설정하지 않으면 true로 처리됩니다. 초대 관리자를 통해 초대된 사용자의 경우 이 속성은 false로 설정됩니다. $filter 지원합니다(eq, ne, NOT, in).

매개 변수 속성

매개 변수 집합

-Skill

사용자가 자신의 기술을 열거할 목록입니다. $select만 반환됩니다.

매개 변수 속성

매개 변수 집합

-State

사용자 주소의 시/도입니다. 최대 길이는 128자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-StreetAddress

사용자 비즈니스 위치의 거리 주소입니다. 최대 길이는 1024자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-Surname

사용자의 성입니다(이름 제외). 최대 길이는 64자입니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-UsageLocation

두 문자 국가 코드(ISO 표준 3166)입니다. 국가의 서비스 가용성을 확인하기 위한 법적 요구 사항으로 인해 라이선스가 할당되는 사용자에게 필요합니다. 미국, JP 및 GB를 예로 들면 다음과 같습니다. Null을 허용하지 않습니다. $filter 지원합니다(eq, ne, NOT, ge, le, in, startsWith).

매개 변수 속성

매개 변수 집합

-UserPrincipalName

사용자의 UPN(사용자 계정 이름)입니다. UPN은 인터넷 표준 RFC 822를 기반으로 하는 사용자의 인터넷 스타일 로그인 이름입니다. 규칙에 따라 사용자의 이메일 이름에 매핑됩니다. 일반 형식은 alias@___domain. 여기서 도메인은 테넌트의 확인된 도메인 컬렉션에 있어야 합니다. 이 속성은 사용자를 만들 때 필요합니다. 테넌트에 대해 확인된 도메인은 조직의 verifiedDomains 속성에서 액세스할 수 있습니다. 참고: 이 속성에는 악센트 문자를 포함할 수 있지만 사용자의 자사 애플리케이션에 대한 액세스 문제가 발생할 수 있습니다. $filter(eq, ne, NOT, ge, le, in, startsWith, endsWith) 및 $orderBy 지원합니다.

매개 변수 속성

매개 변수 집합

-UserType

멤버 및 게스트와 같은 디렉터리에서 사용자 형식을 분류하는 데 사용할 수 있는 문자열 값입니다. $filter 지원합니다(eq, ne, NOT, in,).

매개 변수 속성

매개 변수 집합

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

매개 변수 집합

CommonParameters

출력

IMicrosoftGraphUser