이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

Get-MailUser

 

적용 대상:Exchange Online, Exchange Online Protection, Exchange Server 2016

마지막으로 수정된 항목:2017-03-30

이 cmdlet은 온-프레미스 Exchange Server 2016 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Get-MailUser cmdlet을 사용하여 메일 사용자와 클라우드 환경의 Office 365 그룹 게스트 사용자를 볼 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하세요.

Get-MailUser [-Identity <MailUserIdParameter>] <COMMON PARAMETERS>

Get-MailUser [-ArchiveDatabase <DatabaseIdParameter>] <COMMON PARAMETERS>

Get-MailUser [-Anr <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-AccountPartition <AccountPartitionIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SoftDeletedMailUser <SwitchParameter>] [-SortBy <String>] [-UsnForReconciliationSearch <Int64>]

이 예에서는 조직 내 모든 메일 사용자의 요약 목록을 반환합니다.

Get-MailUser

이 예에서는 메일 사용자 Ed에 대한 세부 정보를 반환합니다.

Get-MailUser -Identity Ed | Format-List

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하세요. 받는 사람에 게 사용 권한의 "받는 사람의 프로비전 권한" 섹션

 

매개 변수 필수 종류 설명

AccountPartition

선택

Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Anr

선택

System.String

Anr 매개 변수는 ANR(모호한 이름 확인) 검색을 수행할 문자열을 지정합니다. 부분 문자열을 지정하고 해당 문자열과 일치하는 특성의 개체를 검색할 수 있습니다. 검색되는 기본 특성은 다음과 같습니다.

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

ArchiveDatabase

옵션

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Credential

선택

System.Management.Automation.PSCredential

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

Credential 매개 변수는 이 명령을 실행하는 데 사용되는 사용자 이름과 암호를 지정합니다. 일반적으로는 필요한 권한이 있는 여러 자격 증명을 제공해야 하는 경우나 스크립트를 사용하는 경우 이 매개 변수를 사용합니다.

이 매개 변수는 자격 증명 개체의 생성 및 전달이 필요합니다. 이 자격 증명 개체는 Get-Credential cmdlet을 사용하여 만들어집니다. 자세한 내용은 Get-Credential을 참조하세요.

DomainController

옵션

Microsoft.Exchange.Data.Fqdn

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 데이터를 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화 된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

Filter

선택

System.String

Filter 매개 변수는 받는 사람을 필터링하는 데 사용되는 OPath 필터를 나타냅니다.

필터링할 수 있는 속성에 대한 자세한 내용은 Filterable properties for the -Filter parameter을 참고하세요.

Identity

옵션

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Identity 매개 변수는 보려는 메일 사용자를 지정합니다. 메일 사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다.

예를 들면 다음과 같습니다.

  • 이름

  • 표시 이름

  • 별칭

  • DN(고유 이름)

  • 정식 DN

  • 전자 메일 주소

  • GUID

IgnoreDefaultScope

선택

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

IgnoreDefaultScope 스위치는 명령이 Exchange 관리 셸 세션에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이 경우 명령은 현재 기본 범위에서 사용할 수 없는 Active Directory 개체에 액세스할 수 있습니다.

IgnoreDefaultScope 스위치를 사용하면 다음과 같은 제한이 적용됩니다.

  • DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.

  • Identity 매개 변수의 DN만 사용할 수 있습니다. 별칭 또는 GUID와 같이 다른 식별 형식은 허용되지 않습니다.

Organization

옵션

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 Active Directory 내의 개체 위치를 기준으로 결과를 필터링합니다. 지정된 위치에 있는 개체만 반환됩니다. 이 매개 변수에 사용할 수 있는 입력은 Get-OrganizationalUnit cmdlet을 사용하여 표시되는 OU(조직 구성 단위) 또는 도메인입니다. OU 또는 도메인을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • DN(고유 이름)

  • DN(고유 이름)

  • GUID

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

이 매개 변수는 온-프레미스 Exchange 2016에서만 제공됩니다.

ReadFromDomainController 스위치는 사용자 도메인의 도메인 컨트롤러에서 정보를 읽도록 지정합니다. Set-AdServerSettings -ViewEntireForest $true 명령을 실행하여 모든 개체를 포리스트에 포함하고 ReadFromDomainController 스위치를 사용하지 않으면 오래된 정보가 포함된 글로벌 카탈로그에서 정보를 읽을 수 있습니다. ReadFromDomainController 스위치를 사용하는 경우에는 정보를 가져오기 위해 읽기를 여러 번 수행해야 할 수 있습니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

note참고:
기본적으로 받는 사람 범위는 Exchange 서버를 호스팅하는 도메인에 설정됩니다.

ResultSize

옵션

Microsoft.Exchange.Data.Unlimited

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1000입니다.

SoftDeletedMailUser

선택

System.Management.Automation.SwitchParameter

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

SoftDeletedMailUser 스위치는 결과에 일시적으로 삭제 된 메일 사용자를 포함할지 여부를 지정 합니다. 이 스위치와 함께 값을 지정할 필요가 없습니다.

이 스위치는 메일 일시 삭제 된 사용자를 반환 하려면 필요 합니다.

일시 삭제 된 메일 사용자는 삭제 한 메일 사용자는 여전히 복구할 수입니다.

SortBy

옵션

System.String

SortBy 매개 변수는 결과의 정렬 기준으로 사용할 속성을 지정합니다. 한 번에 하나의 속성에 대해 정렬이 수행됩니다. 결과는 오름차순으로 정렬됩니다.

기본 보기에 정렬 기준으로 사용할 속성이 포함되어 있지 않으면 | Format-Table -Auto <Property1>,<Property2>...를 명령에 추가하여 표시하려는 모든 속성이 포함된 새로운 보기를 만들 수 있습니다. 속성 이름에 와일드카드(*)를 사용할 수 있습니다.

다음과 같은 속성으로 정렬할 수 있습니다.

  • name

  • DisplayName

  • alias

UsnForReconciliationSearch

옵션

System.Int64

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

 
표시: