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 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 참조 페이지에 나열된 다른 권한 중 하나에 scope 권한이 필요합니다. 이 문서의 일부 명령에는 다른 사용 권한 범위가 필요할 수 있으며, 이 경우 관련 섹션에 설명되어 있습니다.

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

다중 사용자 계정 만들기

  1. 필요한 사용자 계정 정보를 포함 하는 쉼표로 구분 된 값 (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 명령에서 매개 변수 값에 대한 열 이름을 사용합니다.

  2. 이 예제 에서는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

  3. 결과 볼 수 있는 출력 파일을 검토 합니다.

참고 항목

PowerShell로 Microsoft 365 사용자 계정, 라이선스 및 그룹 관리

PowerShell로 Microsoft 365 관리

Microsoft 365 용 PowerShell 시작