Get-EXOMailbox

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online

이 cmdlet은 Exchange Online PowerShell 모듈에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.

Get-EXOMailbox cmdlet을 사용하여 사서함 개체 및 특성을 보거나, 속성 페이지를 채웁니다. 또는 사서함 정보를 다른 작업에 제공합니다.

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

Syntax

Get-EXOMailbox
   [[-Identity] <String>]
   [-Archive]
   [-Async]
   [-ExternalDirectoryObjectId <Guid>]
   [-Filter <String>]
   [-GroupMailbox]
   [-InactiveMailboxOnly]
   [-IncludeInactiveMailbox]
   [-MailboxPlan <String>]
   [-Migration]
   [-OrganizationalUnit <String>]
   [-PrimarySmtpAddress <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-PublicFolder]
   [-RecipientTypeDetails <String[]>]
   [-ResultSize <Unlimited>]
   [-SoftDeletedMailbox]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Get-EXOMailbox
   [-Anr <String>]
   [-Archive]
   [-Async]
   [-Filter <String>]
   [-GroupMailbox]
   [-InactiveMailboxOnly]
   [-IncludeInactiveMailbox]
   [-MailboxPlan <String>]
   [-Migration]
   [-OrganizationalUnit <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-PublicFolder]
   [-RecipientTypeDetails <String[]>]
   [-ResultSize <Unlimited>]
   [-SoftDeletedMailbox]
   [<CommonParameters>]

Description

기본적으로 이 cmdlet은 조직의 모든 사서함에 대한 요약 목록(최소 속성 집합)을 반환합니다.

예제

예 1

Get-EXOMailbox -ResultSize unlimited

이 예제에서는 조직의 모든 사서함에 대한 요약 목록을 반환하고 기본 최소 출력 속성 집합을 포함합니다. 추가 속성을 반환하려면 Properties 및/또는 PropertySets 매개 변수를 사용합니다.

예 2

Get-EXOMailbox -PropertySets Archive

다음은 보관 속성 집합에 정의된 속성을 반환하는 예제입니다. 이러한 속성의 전체 목록은 Get-EXOMailbox 속성 집합을 참조하세요.

예 3

Get-EXOMailbox -Properties Name,DistinguishedName,Guid -PropertySets Archive,Audit

이 예제에서는 조직의 모든 사서함에 대한 요약 목록을 반환하고 다음 속성을 포함합니다.

보관 및 감사 속성 집합의 속성입니다.
Name 및 DistinguishedName 속성입니다.

예 4

Get-EXOMailbox -Identity John@contoso.com -Properties DisplayName,EmailAddresses,Alias

다음은 사서함 John@contoso.com에 대해 지정된 속성을 반환하는 예제입니다.

매개 변수

-Anr

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

CommonName(CN)
DisplayName
FirstName
LastName
별칭

ExternalDirectoryObjectId, Identity, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Archive

보관 스위치는 보관을 사용하도록 설정된 사서함별로 결과를 필터링합니다(보관 사서함이 있는 사서함만 반환됨). 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Async

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExternalDirectoryObjectId

ExternalDirectoryObjectId 매개 변수는 Azure Active Directory의 ObjectId에서 보려는 사서함을 식별합니다.

Anr, Identity, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

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

-Filter

Filter 매개 변수는 OPATH 구문을 사용하여 지정된 속성 및 값으로 결과를 필터링합니다. 검색 조건은 구문을 "Property -ComparisonOperator 'Value'"사용합니다.

전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
속성은 필터링 가능한 속성입니다. 필터링 가능한 속성에 대한 자세한 내용은 Filter 매개 변수에 대한 Get-EXOMailbox 속성 집합 및 필터링 가능한 속성을 참조하세요.
ComparisonOperator는 OPATH 비교 연산자입니다(예 -eq : 같음 및 -like 문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요.
값은 검색할 속성 값입니다. 텍스트 값과 변수를 작은따옴표('Value' 또는 '$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를 '$User'사용합니다 '$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , , $true$false또는 $null 를 대신 사용500).

논리 연산자 -and 및 -or를 사용하여 여러 검색 조건을 함께 연결할 수 있습니다. 예를 들어 "Criteria1 -and Criteria2" 또는 "(Criteria1 -and Criteria2) -or Criteria3"입니다.

Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-GroupMailbox

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Identity 매개 변수는 보려는 사서함을 지정합니다. 최상의 성능을 위해 다음 값을 사용하는 것이 좋습니다.

사용자 ID 또는 UPN(사용자 계정 이름)
GUID

그렇지 않으면 사서함을 고유하게 식별하는 값을 사용할 수 있습니다. 예시:

이름
별칭
DN(고유 이름)
Domain\Username
전자 메일 주소
LegacyExchangeDN
SamAccountName

Anr, ExternalDirectoryObjectId, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

Type:	String
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-InactiveMailboxOnly

InactiveMailboxOnly 스위치는 결과에 비활성 사서함만 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

비활성 사서함은 일시 삭제되기 전에 원본 위치 유지 또는 소송 보존 상태로 설정된 사서함입니다. 비활성 사서함의 콘텐츠는 보류를 제거할 때까지 보존됩니다.

결과에 활성 사서함과 비활성 사서함을 모두 반환하려면 이 스위치를 사용하지 마세요. 대신 IncludeInactiveMailbox 스위치를 사용합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IncludeInactiveMailbox

IncludeInactiveMailbox 스위치는 결과에 비활성 사서함을 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

결과에 비활성 사서함만 반환하려면 이 스위치를 사용하지 마세요. 대신 InactiveMailboxOnly 스위치를 사용합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MailboxPlan

MailboxPlan 매개 변수는 결과를 사서함 계획별로 필터링합니다. 이 매개 변수를 사용할 때는 지정한 사서함 계획에 할당된 사서함만 결과에 포함됩니다. 사서함 계획을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
별칭
표시 이름
DN(고유 이름)
GUID

사서함 계획은 클라우드 기반 조직의 사서함 사용자가 사용할 수 있는 권한 및 기능을 지정합니다. Get-MailboxPlan cmdlet을 통해 사용 가능한 사서함 계획을 확인할 수 있습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Migration

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-OrganizationalUnit

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

이름
이름
DN(고유 이름)
GUID

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PrimarySmtpAddress

PrimarySmtpAddress는 기본 SMTP 전자 메일 주소(예 navin@contoso.com: )로 보려는 사서함을 식별합니다.

Anr, ExternalDirectoryObjectId, Identity 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

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

-Properties

Properties 매개 변수는 이 cmdlet의 출력에 반환되는 속성을 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

사용 가능한 속성에 대한 자세한 내용은 Get-EXOMailbox 속성 집합을 참조하세요.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PropertySets

PropertySets 매개 변수는 이 cmdlet의 출력에 반환되는 속성의 논리적 그룹화 를 지정합니다. 유효한 값은 다음과 같습니다.

전체
최소값(기본값)
AddressList
보관
감사
사용자 지정
배달
Hold
중재 제한
이동
정책
PUBLICFOLDER
할당량
리소스
보존
SCL
SoftDelete
StatisticsSeed

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

각 속성 집합에 포함된 속성에 대한 자세한 내용은 Get-EXOMailbox 속성 집합을 참조하세요.

Type:	PropertySet[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PublicFolder

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RecipientTypeDetails

RecipientTypeDetails 매개 변수는 지정된 사서함 하위 형식으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

DiscoveryMailbox
EquipmentMailbox
GroupMailbox
LegacyMailbox
LinkedMailbox
LinkedRoomMailbox
RoomMailbox
SchedulingMailbox
SharedMailbox
TeamMailbox
UserMailbox

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ResultSize

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

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SoftDeletedMailbox

결과에서 일시 삭제된 사서함을 반환하려면 SoftDeletedMailbox 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

일시 삭제된 사서함은 삭제되었지만 복구할 수 있는 사서함입니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-UserPrincipalName

UserPrincipalName 매개 변수는 UPN(예 navin@contoso.onmicrosoft.com: )으로 보려는 사서함을 식별합니다.

Anr, ExternalDirectoryObjectId, Identity 또는 PrimarySmtpAddress 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

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

입력

Input types

Get-EXOMailbox에서는 다음 Get-Mailbox 매개 변수를 사용할 수 없거나 작동하지 않습니다.

Async
GroupMailbox
마이그레이션
PUBLICFOLDER
SortBy

출력

Output types

다음 속성은 Get-EXOMailbox의 출력에 포함되지 않습니다.

RunspaceId
Servername
AdminDisplayVersion
DelayReleaseHoldApplied
EnforcedTimestamps
설명
OriginatingServer
Isvalid
ObjectState

Get-EXOMailbox

Syntax

Description

예제

예 1

예 2

예 3

예 4

매개 변수

-Anr

-Archive

-Async

-ExternalDirectoryObjectId

-Filter

-GroupMailbox

-Identity

-InactiveMailboxOnly

-IncludeInactiveMailbox

-MailboxPlan

-Migration

-OrganizationalUnit

-PrimarySmtpAddress

-Properties

-PropertySets

-PublicFolder

-RecipientTypeDetails

-ResultSize

-SoftDeletedMailbox

-UserPrincipalName

입력

출력

피드백

피드백

추가 리소스