Get-MsolUser

모듈:

MSOnline

Azure Active Directory에서 사용자를 가져옵니다.

Syntax

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

이 cmdlet이 모든 결과를 반환한다는 것을 나타냅니다. MaxResults 매개 변수와 함께 지정하지 마세요.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-City

결과를 필터링할 도시를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Country

결과를 필터링할 국가 또는 지역을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Department

결과를 필터링할 부서를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainName

결과를 필터링할 도메인을 지정합니다. 회사에 대해 확인된 도메인이어야 합니다. 이 도메인에서 기본 또는 보조 전자 메일 주소를 가진 모든 사용자가 반환됩니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnabledFilter

사용하거나 사용하지 않도록 설정된 사용자에 대한 필터를 지정합니다. 유효한 값은 All, EnabledOnly 및 DisabledOnly입니다.

Type:	UserEnabledFilter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HasErrorsOnly

이 cmdlet은 유효성 검사 오류가 있는 사용자만 반환한다는 것을 확인합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseReconciliationNeededOnly

이 cmdlet은 라이선스 조정이 필요한 사용자에 대해서만 필터링됨을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxResults

이 cmdlet이 반환하는 최대 결과 수를 지정합니다. 기본값은 500입니다.

Type:	Int32
Position:	Named
Default value:	500
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

가져올 사용자의 고유 개체 ID를 지정합니다.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnDeletedUsers

이 cmdlet은 휴지통에 있는 사용자만 반환함을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SearchString

이 문자열로 시작하는 전자 메일 주소 또는 표시 이름과 일치하는 문자열을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-State

사용자 상태에 대한 필터를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Synchronized

이 cmdlet은 Azure Active Directory 동기화를 통해 동기화된 사용자만 반환한다는 것을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Title

사용자의 타이틀에 대한 필터를 Speicifs합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnlicensedUsersOnly

이 cmdlet은 라이선스가 할당되지 않은 사용자만 반환한다는 것을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UsageLocation

사용자가 서비스를 사용하는 국가 또는 지역에 대한 필터를 지정합니다. 두 글자로 된 국가 또는 지역 코드를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPrincipalName

검색할 사용자의 사용자 ID를 Speicifs합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

출력

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