PowerShell을 사용하여 Microsoft 365 사용자 계정 만들기
이 문서는 Microsoft 365 Enterprise와 Office 365 Enterprise에 모두 적용됩니다.
Microsoft Graph PowerShell을 사용하여 여러 계정을 포함하여 사용자 계정을 효율적으로 만들 수 있습니다.
PowerShell에서 사용자 계정을 만들 때 특정 계정 속성은 항상 필요합니다. 다른 속성은 필요하지 않지만 중요합니다. 다음 표를 참고하십시오.
| 속성 이름 | 필수 여부 | 설명 |
|---|---|---|
|
DisplayName |
예 |
Microsoft 365 서비스에서 사용되는 표시 이름입니다. 예를 들어 Caleb Sills입니다. |
|
UserPrincipalName |
예 |
Microsoft 365 서비스에 로그인하는 데 사용되는 계정 이름입니다. 예를 들면 CalebS@contoso.onmicrosoft.com와 같습니다. |
|
FirstName |
아니요 |
|
|
LastName |
아니요 |
|
|
LicenseAssignment |
아니오 |
이는 사용 가능한 라이선스가 사용자 계정에 할당되는 라이선스 계획(라이선스 계획 또는 SKU라고도 함)입니다. 라이선스는 계정에서 사용할 수 있는 Microsoft 365 서비스를 정의합니다. 계정을 만들 때 사용자에게 라이선스를 할당할 필요는 없지만 계정에는 Microsoft 365 서비스에 액세스할 수 있는 라이선스가 있어야 합니다. 사용자 계정을 만든 후 30일 동안 라이선스를 부여해야 합니다. |
|
Password |
아니요 |
암호를 지정 하지 않으면 사용자 계정에 임의의 암호를 할당 하 고 암호는 명령의 결과에 표시 됩니다. 암호를 지정하는 경우 소문자, 대문자, 숫자 및 기호 형식의 8~16개의 ASCII 텍스트 문자여야 합니다. |
|
UsageLocation |
아니요 |
유효한 ISO 3166-1 alpha-2 국가 코드입니다. 예를 들어 미국의 경우 미국 , 프랑스의 경우 FR 입니다. 일부 Microsoft 365 서비스는 특정 국가/지역에서 사용할 수 없으므로 이 값을 제공하는 것이 중요합니다. 계정에 이 값이 구성되어 있지 않으면 사용자 계정에 라이선스를 할당할 수 없습니다. 자세한 내용은 라이선스 제한 정보를 참조하세요. |
Microsoft Graph PowerShell을 사용하여 Microsoft 365 사용자 계정 만들기
참고
Azure Active Directory 모듈은 Microsoft Graph PowerShell SDK로 대체됩니다. Microsoft Graph PowerShell SDK를 사용하여 모든 Microsoft Graph API에 액세스할 수 있습니다. 자세한 내용은 Microsoft Graph PowerShell SDK 시작하기를 참조하세요.
먼저 Microsoft Entra DC 관리자 또는 클라우드 애플리케이션 관리자 계정을 사용하여 Microsoft 365 테넌트 연결합니다. 이 문서의 cmdlet에는 사용 권한 범위 User.ReadWrite.All 또는 'List subscribedSkus' Graph API 참조 페이지에 나열된 다른 권한 중 하나가 필요합니다. 이 문서의 일부 명령에는 다른 사용 권한 범위가 필요할 수 있으며, 이 경우 관련 섹션에 설명되어 있습니다.
Connect-MgGraph -Scopes "User.ReadWrite.All"
개별 사용자 계정 만들기
개별 계정을 만들려면 다음 구문을 사용합니다.
$PasswordProfile = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphPasswordProfile
$PasswordProfile.Password = "<user account password>"
New-MgUser -DisplayName "<display name>" -GivenName "<first name>" -Surname "<last name>" -UserPrincipalName <sign-in name> -UsageLocation <ISO 3166-1 alpha-2 country code> -MailNickname <mailbox name> -PasswordProfile $PasswordProfile -AccountEnabled $true
이 예제에서는 미국 사용자 John Doe에 대한 계정을 만듭니다.
$PasswordProfile = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphPasswordProfile
$PasswordProfile.Password = "3Rv0y1q39/chsy"
New-MgUser -DisplayName "John Doe" -GivenName "John" -Surname "Doe" -UserPrincipalName johnd@contoso.onmicrosoft.com -UsageLocation "US" -MailNickname "johnd" -PasswordProfile $PasswordProfile -AccountEnabled $true
다중 사용자 계정 만들기
필요한 사용자 계정 정보를 포함 하는 쉼표로 구분 된 값 (CSV) 파일을 만듭니다. 예:
UserPrincipalName,FirstName,LastName,DisplayName,UsageLocation,MailNickname ClaudeL@contoso.onmicrosoft.com,Claude,Loiselle,Claude Loiselle,US,claudel LynneB@contoso.onmicrosoft.com,Lynne,Baxter,Lynne Baxter,US,lynneb ShawnM@contoso.onmicrosoft.com,Shawn,Melendez,Shawn Melendez,US,shawnm참고
CSV 파일의 첫 번째 행에 있는 열 이름과 순서는 임의입니다. 그러나 파일의 나머지 부분에 있는 데이터의 순서가 열 이름의 순서와 일치하는지 확인합니다. 또한 Microsoft 365용 PowerShell 명령에서 매개 변수 값에 대한 열 이름을 사용합니다.
이 예제 에서는C:\temp\NewAccounts.csv파일 에서 사용자 계정을 만들고 C:\temp\NewAccountResults.csv파일에 결과를 기록합니다.
# Import the CSV file $users = Import-Csv -Path "C:\temp\NewAccounts.csv" # Create a password profile $PasswordProfile = @{ Password = 'Password123' } # Loop through each user in the CSV file foreach ($user in $users) { # Create a new user $newUser = New-MgUser -DisplayName $user.DisplayName -GivenName $user.FirstName -Surname $user.LastName -UserPrincipalName $user.UserPrincipalName -UsageLocation $user.UsageLocation -MailNickname $user.MailNickname -PasswordProfile $passwordProfile -AccountEnabled # Assign a license to the new user $e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5' Set-MgUserLicense -UserId $newUser.Id -AddLicenses @{SkuId = $e5Sku.SkuId} -RemoveLicenses @() } # Export the results to a CSV file $users | Export-Csv -Path "C:\temp\NewAccountResults.csv" -NoTypeInformation결과 볼 수 있는 출력 파일을 검토 합니다.