다음을 통해 공유


PowerShell을 사용하여 Microsoft 365 사용자 계정 보기

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

Microsoft 365 관리 센터 사용하여 Microsoft 365 테넌트 계정을 볼 수 있습니다. Microsoft 365용 PowerShell을 사용하면 이 기능을 사용할 수 있지만 추가 기능도 제공합니다.

Microsoft Graph PowerShell을 사용하여 사용자 계정 보기

참고

AzureAD(Azure Active Directory) PowerShell 모듈은 더 이상 사용되지 않으며 Microsoft Graph PowerShell SDK로 대체됩니다. Microsoft Graph PowerShell SDK를 사용하여 모든 Microsoft Graph API에 액세스할 수 있습니다. 자세한 내용은 Microsoft Graph PowerShell SDK 시작하기를 참조하세요.

Microsoft Graph PowerShell을 각각 설치하고 업그레이드하는 방법에 대한 자세한 내용은 Microsoft Graph PowerShell SDK 설치 및 Azure AD PowerShell에서 Microsoft Graph PowerShell로 업그레이드를 참조하세요.

  1. 먼저 Microsoft Graph PowerShell을 사용하는 데 필요한 소프트웨어를 설치합니다. 자세한 내용은 Microsoft Graph PowerShell을 사용하여 Microsoft 365에 연결을 참조하세요.

  2. 그런 다음 다음 cmdlet을 실행하여 필요한 권한 scope 사용하여 organization 연결합니다. 이 경우 User.ReadBasic.All입니다.

# Connect to Microsoft Graph
Connect-Graph -Scopes User.ReadBasic.All

모든 계정 보기

사용자 ID 및 사용자 계정 이름을 사용하여 사용자 계정의 전체 목록을 표시하려면 다음 명령을 실행합니다.

Get-MgUser -All | Select DisplayName,Id,UserPrincipalName

다음과 유사한 정보를 가져와야 합니다.

DisplayName               Id                                   UserPrincipalName
-----------               --                                   -----------------
Conf Room Adams           6e206948-b2b6-406c-a728-80bbe78e4003 Adams@M365x89521157.OnMicrosoft.com
Adele Vance               916a6a08-b9d0-44b6-870f-562d8358a314 AdeleV@M365x89521157.OnMicrosoft.com
MOD Administrator         5710f237-df3f-4bcd-b875-82deb02f98aa admin@M365x89521157.onmicrosoft.com
Alex Wilber               8aa561dc-441d-4d74-aeb3-e2be41c116c8 AlexW@M365x89521157.OnMicrosoft.com
Allan Deyoung             6b629e5e-3cf4-42d0-8007-3a93f0253382 AllanD@M365x89521157.OnMicrosoft.com
Automate Bot              3a70feb4-9407-47b5-9b61-7526ac0e98d8 AutomateB@M365x89521157.OnMicrosoft.com      
Conf Room Baker           d8cf3fef-1d03-4b9c-9be0-fed44fb87596 Baker@M365x89521157.OnMicrosoft.com
Bianca Pisani             7fe8c2d1-eb8e-4032-96ba-26242ff0acd9 BiancaP@M365x89521157.OnMicrosoft.com        

특정 계정 보기

특정 사용자 계정을 표시하려면 다음 명령을 실행합니다. UPN(사용자 계정 이름)으로도 알려진 사용자 계정의 로그인 계정 이름을 입력합니다. "" 및 "<>" 문자를 제거합니다.

Get-MgUser -UserId '<user principal name>'

다음은 예입니다.

Get-MgUser -UserId 'BelindaN@litwareinc.onmicosoft.com'

특정 계정에 대한 추가 속성 값 보기

기본적으로 Get-MgUser cmdlet은 계정의 DisplayName, Id, MailUserPrincipalName 속성만 표시합니다.

표시할 속성에 대해 더 선택적이려면 Get-MgUser cmdlet과 함께 Select cmdlet을 사용합니다. 두 cmdlet을 결합하려면 PowerShell에 한 명령의 결과를 가져와서 다음 명령으로 보내도록 지시하는 "파이프" 문자("|")를 사용합니다. 다음은 모든 사용자 계정에 대한 DisplayName, DepartmentUsageLocation 을 표시하는 예제 명령입니다.

Get-MgUser -All | Select DisplayName,Department,UsageLocation

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

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

  2. 사용자 계정 이름, 부서 및 사용 위치만 표시합니다(DisplayName, Department, UsageLocation 선택).

특정 사용자 계정에 대한 모든 속성을 보려면 Select cmdlet 및 와일드카드 문자(*)를 사용합니다. 다음은 예입니다.

Get-MgUser -UserID 'BelindaN@litwareinc.onmicosoft.com' | Select *

또 다른 예로 다음 명령을 실행하여 특정 사용자 계정의 활성화된 상태 검사.

Get-MgUser -UserID '<sign-in name of the user account>' | Select DisplayName,UserPrincipalName,AccountEnabled

계정 동기화 상태 보기

사용자 계정에는 다음 두 가지 원본이 있습니다.

  • 온-프레미스 AD에서 클라우드로 동기화되는 계정인 AD(Windows Server Active Directory)입니다.

  • Microsoft Entra 클라우드에서 직접 만들어지는 계정입니다.

다음 명령을 사용하여 온-프레미스 AD에서 동기화하는 계정을 찾을 수 있습니다. OnPremisesSyncEnabled 특성을 가진 모든 사용자를 True로 설정하도록 PowerShell에 지시합니다.

Get-MgUser -All -Filter 'OnPremisesSyncEnabled eq true'

다음 명령을 사용하여 클라우드 전용 계정을 찾을 수 있습니다. PowerShell에 OnPremisesSyncEnabled 특성이 False로 설정되었거나 설정되지 않은 모든 사용자를 얻도록 지시합니다(Null). 온-프레미스 AD에서 동기화되지 않은 계정에 는 OnPremisesSyncEnabled가Null로 설정됩니다. 온-프레미스 AD에서 처음 동기화되었지만 더 이상 동기화되지 않는 계정에 는 OnPremisesSyncEnabledFalse로 설정됩니다.

Get-MgUser -All | Where OnPremisesSyncEnabled -ne true
OnPremisesSyncEnabled

공통 속성을 기반으로 계정 보기

표시할 계정 목록에 대해 더 선택적으로 표시하려면 Get-MgUser cmdlet과 함께 Where cmdlet을 사용할 수 있습니다. 두 cmdlet을 결합하려면 PowerShell에 한 명령의 결과를 가져와서 다음 명령으로 보내도록 지시하는 "파이프" 문자("|")를 사용합니다. 다음은 지정되지 않은 사용 위치가 있는 사용자 계정만 표시하는 예제 명령입니다.

Get-MgUser | Where UsageLocation -eq $Null

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

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

  2. 지정되지 않은 사용 위치(UsageLocation -eq $Null)가 있는 모든 사용자 계정을 찾습니다. 명령은 UsageLocation 사용자 계정 속성(UsageLocation)이 지정되지 않은 계정 집합만 찾도록 PowerShell에 지시합니다(-eq $Null).

UsageLocation 속성은 사용자 계정과 연결된 여러 속성 중 하나일 뿐입니다. 특정 사용자 계정에 대한 모든 속성을 표시하려면 Select cmdlet 및 와일드카드 문자(*)를 사용합니다. 다음은 예입니다.

Get-MgUser -UserID BelindaN@litwareinc.onmicosoft.com | Select *

예를 들어 City 는 사용자 계정 속성의 이름입니다. 다음 명령을 사용하여 런던에 거주하는 사용자의 모든 계정을 나열할 수 있습니다.

Get-MgUser | Where City -eq "London"

이 예제에서 Where cmdlet의 구문은 Where [user account property name] [comparison operator] [value] value입니다.> [비교 연산자]는 -eq for equals, -ne for not equals, -lt for less than, -gt for greater than 및 기타입니다. [value]는 일반적으로 문자열(문자, 숫자 및 기타 문자 시퀀스), 숫자 값 또는 지정되지 않은 $Null . 자세한 내용은 위치를 참조하세요.

참고 항목

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

PowerShell로 Microsoft 365 관리

Microsoft 365용 PowerShell 시작