Get-MsolUser

구문

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]

Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolUser cmdlet은 개별 사용자 또는 사용자 목록을 가져옵니다. ObjectId 또는 UserPrincipalName 매개 변수를 지정하여 특정 사용자를 가져옵니다.

예제

예제 1: 모든 사용자 가져오기

PS C:\> Get-MsolUser

이 명령은 회사의 모든 사용자를 검색합니다. 최대 500개의 결과를 기본값으로 표시합니다.

예제 2: 사용하도록 설정된 사용자 가져오기

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

이 명령은 최대 2,000명의 사용자를 지원합니다.

예제 3: UPN으로 사용자 가져오기

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

이 명령은 UPN davidchew@contoso.com을 사용하여 사용자를 검색합니다.

예제 4: 개체 ID로 사용자 가져오기

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

이 명령은 지정된 개체 ID가 있는 사용자를 검색합니다.

예제 5: 검색 문자열로 사용자 가져오기

PS C:\> Get-MsolUser -SearchString "David"

이 명령은 표시 이름 또는 이메일 주소에서 David가 있는 사용자 목록을 검색합니다.

예제 6: 사용자의 기본 데이터 위치 가져오기

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

이 명령은 사용자의 기본 설정 데이터 위치를 반환합니다.

매개 변수

-All

-City

-Country

-Department

-DomainName

-EnabledFilter

-HasErrorsOnly

-LicenseReconciliationNeededOnly

-MaxResults

-ObjectId

-ReturnDeletedUsers

-SearchString

-State

-Synchronized

-TenantId

-Title

-UnlicensedUsersOnly

-UsageLocation

-UserPrincipalName

출력

Microsoft.Online.Administration.User

이 cmdlet은 다음 정보를 포함하는 사용자 개체를 반환합니다.

• AlternateEmailAddresses. 사용자의 대체 이메일 주소(Azure Active Directory 외부).

• BlockCredential. 사용자의 로그인 가능 여부입니다.

• 도시. 사용자의 구/군/시입니다.

• 국가입니다. 사용자의 국가 또는 지역입니다.

• 부서. 사용자의 부서입니다.

• DisplayName. 사용자의 표시 이름입니다.

• 오류. 오류 배열입니다. 이러한 오류는 서비스를 사용하지 못하도록 할 수 있는 유효성 검사 오류입니다.

• 팩스. 사용자의 팩스 번호입니다.

• 이름. 사용자의 이름입니다.

• ImmutableID. 페더레이션 사용자에 대해서만 반환되며, Azure Active Directory와 페더레이션하는 데 필요한 ID입니다.

• isBlackBerryUser. 사용자의 BlackBerry 장치 사용 여부를 반환합니다.

• isLicensed입니다. 사용자에게 라이선스가 할당되었는지 여부입니다.

• LastDirSyncTime. 마지막 디렉터리 동기화 날짜 및 시간입니다(Active Directory 동기화를 통해 Azure Active Directory와 동기화된 사용자만 반환됨).

• LastPasswordChangeTimestamp. 사용자의 암호 변경이 Azure Active Directory에 등록된 가장 최근 시간입니다.

• LastName 사용자의 성입니다.

• LicenseReconciliationNeeded. 사용자에게 현재 라이선스가 없는 사서함이 있는지 여부입니다. 이러한 사서함이 있는 경우 사용자는 30일 이내에 라이선스를 받아야 사서함이 손실되지 않습니다.

• 라이센스. 사용자 라이선스 목록입니다.

• LiveID. 사용자의 고유한 로그인 ID입니다.

• MobilePhone. 사용자의 휴대폰 번호입니다.

• Objectid. 사용자의 고유한 ID입니다.

• 사무실. 사용자의 사무실 번호입니다.

• OverallProvisioningStatus. 사용자가 서비스를 사용할 수 있도록 프로비전되었는지 여부입니다.

• PasswordNeverExpires. 사용자의 암호를 90일마다 강제로 변경해야 하는지 여부입니다.

• Phonenumber. 사용자의 전화 번호입니다.

• Postalcode. 사용자의 우편 번호입니다.

• PreferredDataLocation. 사용자의 기본 설정 데이터 위치입니다.

• PreferredLanguage. 사용자의 기본 설정 언어입니다.

• ProxyAddresses. 이 사용자와 연결된 프록시 주소입니다.

• 상태 사용자의 시/도입니다.

• StreetAddress. 사용자의 주소입니다.

• StrongPasswordRequired. 사용자가 암호를 변경할 때 강력한 암호를 설정해야 하는지 여부입니다. 강력한 암호를 사용하는 것이 좋습니다.

• 제목입니다. 사용자의 직함입니다.

• UsageLocation. 사용자가 서비스를 사용하는 국가 또는 지역입니다. 두 글자 국가 또는 지역 코드여야 합니다.

• UserPrincipalName. 사용자의 사용자 ID입니다.

• ValidationStatus입니다. 사용자에게 오류가 발생했는지 여부입니다.

관련 링크

• New-MsolUser
• Remove-MsolUser
• Restore-MsolUser
• Set-MsolUser