PowerShell을 사용하여 Microsoft 365 사용자 계정 속성 구성

  • 아티클

이 문서는 Microsoft 365 Enterprise와 Office 365 Enterprise에 모두 적용됩니다.

Microsoft 365 관리 센터 사용하여 Microsoft 365 테넌트 사용자 계정에 대한 속성을 구성할 수 있습니다. PowerShell에서는 관리 센터에서 수행할 수 없는 몇 가지 다른 작업과 함께 이 작업을 수행할 수도 있습니다.

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"

특정 사용자 계정에 대한 속성 변경

-ObjectID 매개 변수를 사용하여 계정을 식별하고 추가 매개 변수를 사용하여 특정 속성을 설정하거나 변경합니다. 다음은 가장 일반적인 매개 변수 목록입니다.

  • -부서 "<부서 이름>"

  • -DisplayName "<전체 사용자 이름>"

  • -FacsimilieTelephoneNumber "<팩스 번호>"

  • -GivenName "<사용자 이름>"

  • -성 "<사용자 성>"

  • -Mobile "<휴대폰 번호>"

  • -JobTitle "<Job Title>"

  • -PreferredLanguage "<language>"

  • -StreetAddress "<street address>"

  • -City "<city name>"

  • -State "<state name>"

  • -PostalCode "<우편 번호>"

  • -Country "<country name>"

  • -PhoneNumber "<사무실 전화 번호>"

  • -UsageLocation "<2자 국가 또는 지역 코드>"

    ISO 3166-1 alpha-2(A2) 두 글자 국가 또는 지역 코드입니다.

참고

사용자 계정에 라이선스를 할당하려면 먼저 사용 위치를 할당해야 합니다.

사용자 계정의 UPN(사용자 계정 이름)을 표시하려면 다음 명령을 실행합니다.

Get-MgUser -All | Sort-Object UserPrincipalName | Select-Object UserPrincipalName | More

이 명령은 PowerShell에 다음을 지시합니다.

  1. 사용자 계정에 대한 모든 정보(Get-MgUser)를 가져와서 다음 명령(|)으로 보냅니다.

  2. UPN 목록을 사전순으로 정렬하고(UserPrincipalName 정렬) 다음 명령(|)으로 보냅니다.

  3. 각 계정에 대한 UPN 속성만 표시합니다(UserPrincipalName 선택).

  4. 한 번에 하나의 화면(자세히)을 표시합니다.

표시 이름(이름 및 성)에 따라 계정의 UPN을 표시하려면 다음 명령을 실행합니다. $userName 변수를 입력하고 및 > 문자를 제거 < 합니다.

$userName="<Display name>"
Write-Host (Get-MgUser -All | where {$_.DisplayName -eq $userName}).UserPrincipalName

다음은 표시 이름 Caleb Sills인 사용자 계정의 UPN을 표시하는 예제입니다.

$userName="Caleb Sills"
Write-Host (Get-MgUser -All | where {$_.DisplayName -eq $userName}).UserPrincipalName

$upn 변수를 사용하면 표시 이름에 따라 개별 계정을 변경할 수 있습니다. 다음은 벨린다 뉴먼의 사용 위치를 프랑스로 설정하는 예제입니다. 그러나 UPN이 아닌 표시 이름을 지정합니다.

$userName="Belinda Newman"
$upn=(Get-MgUser | where {$_.DisplayName -eq $userName}).UserPrincipalName
Update-MgUser -UserId $upn -UsageLocation "FR"

모든 사용자 계정에 대한 속성 변경

모든 사용자의 속성을 변경하려면 Get-MgUser 및 Update-MgUser cmdlet의 조합을 사용할 수 있습니다. 다음 예제에서는 모든 사용자의 사용 위치를 프랑스로 변경합니다.

Get-MgUser | ForEach-Object { Update-MgUser -UserId $_.Id -UsageLocation "FR" }

이 명령은 PowerShell에 다음을 지시합니다.

  1. 사용자 계정에 대한 모든 정보(Get-MgUser)를 가져와서 다음 명령(|)으로 보냅니다.

  2. 사용자 위치를 프랑스로 설정합니다(Update-MgUser -UsageLocation FR).

특정 사용자 계정 집합에 대한 속성 변경

특정 사용자 계정 집합에 대한 속성을 변경하려면 Get-MgUser, Where 및 Update-MgUser cmdlet의 조합을 사용할 수 있습니다. 다음 예제에서는 회계 부서의 모든 사용자에 대한 사용 위치를 프랑스로 변경합니다.

Get-MgUser -All | Where-Object {$_.Department -eq "Accounting"} | ForEach-Object {Update-MgUser -UserId $_.Id -UsageLocation "FR"}

이 명령은 PowerShell에 다음을 지시합니다.

  1. 사용자 계정에 대한 모든 정보(Get-MgUser)를 가져와서 다음 명령(|)으로 보냅니다.

  2. 해당 Department 속성이 "Accounting"(여기서 {$_)으로 설정된 모든 사용자 계정을 찾습니다. Department -eq "Accounting"}) 및 결과 정보를 다음 명령(|)으로 보냅니다.

  3. 사용자 위치를 프랑스로 설정합니다(Update-MgUser -UsageLocation FR).

참고 항목

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

PowerShell로 Microsoft 365 관리

Microsoft 365용 PowerShell 시작