Get-EXORecipient
이 cmdlet은 Exchange Online PowerShell 모듈에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
Get-EXORecipient cmdlet을 사용하여 organization 기존 받는 사람 개체를 볼 수 있습니다. 이 cmdlet은 사서함, 메일 사용자, 메일 연락처, 메일 그룹 등 메일 사용이 가능한 모든 개체를 반환합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Identity (기본값)
Get-EXORecipient
[[-Identity] <String>]
[-ExternalDirectoryObjectId <Guid>]
[-Filter <String>]
[-IncludeSoftDeletedRecipients]
[-OrganizationalUnit <String>]
[-PrimarySmtpAddress <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-RecipientPreviewFilter <String>]
[-RecipientType <String[]>]
[-RecipientTypeDetails <String[]>]
[-ResultSize <Unlimited>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Anr
Get-EXORecipient
[-Anr <String>]
[-Filter <String>]
[-IncludeSoftDeletedRecipients]
[-OrganizationalUnit <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-RecipientPreviewFilter <String>]
[-RecipientType <String[]>]
[-RecipientTypeDetails <String[]>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Get-EXORecipient cmdlet을 사용하여 organization 기존 받는 사람 개체를 볼 수 있습니다. 이 cmdlet은 사서함, 메일 사용자, 메일 연락처, 메일 그룹 등 메일 사용이 가능한 모든 개체를 반환합니다.
예제
예 1
Get-EXORecipient -ResultSize 100
다음은 이름 정렬 순서로 처음 100명의 받는 사람 개체를 반환하는 예제입니다.
예 2
Get-EXORecipient -Identity john@contosot.com
이 예제에서는 사용자의 받는 사람 특성 세부 정보를 반환합니다. john@contoso.com
매개 변수
-Anr
적용 가능: Exchange Online
Anr 매개 변수는 ANR(모호한 이름 확인) 검색을 수행할 문자열을 지정합니다. 부분 문자열을 지정하고 해당 문자열과 일치하는 특성의 개체를 검색할 수 있습니다. 검색되는 기본 특성은 다음과 같습니다.
- CommonName(CN)
- DisplayName
- FirstName
- LastName
- 별칭
ExternalDirectoryObjectId, Identity, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Anr
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ExternalDirectoryObjectId
적용 가능: Exchange Online
ExternalDirectoryObjectId 매개 변수는 Microsoft Entra ID ObjectId에서 보려는 받는 사람을 식별합니다.
Anr, Identity, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Filter
적용 가능: Exchange Online
Filter 매개 변수는 OPATH 구문을 사용하여 지정된 속성 및 값으로 결과를 필터링합니다. 검색 조건은 구문을 "Property -ComparisonOperator 'Value'"사용합니다.
- 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예
$true: ,$false또는$null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다. - 속성은 필터링 가능한 속성입니다. 필터링 가능한 속성에 대한 자세한 내용은 Filter 매개 변수에 대한 Get-EXORecipient 속성 집합 및 Filterable 속성을 참조하세요.
- 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 구문 정보를 참조하세요.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Online
Identity 매개 변수는 보려는 받는 사람 개체를 지정합니다. 최상의 성능을 위해 다음 값을 사용하여 받는 사람을 식별하는 것이 좋습니다.
- 사용자 ID 또는 UPN(사용자 계정 이름)
- GUID
그렇지 않으면 받는 사람을 고유하게 식별하는 값을 사용할 수 있습니다. 예시:
- 이름
- 별칭
- DN(고유 이름)
- Domain\Username
- 전자 메일 주소
- LegacyExchangeDN
- SamAccountName
Anr, ExternalDirectoryObjectId, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-IncludeSoftDeletedRecipients
적용 가능: Exchange Online
IncludeSoftDeletedRecipients 스위치는 일시 삭제된 수신자를 결과에 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
일시 삭제된 받는 사람은 여전히 복구할 수 있는 삭제된 받는 사람입니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-OrganizationalUnit
적용 가능: Exchange Online
OrganizationalUnit 매개 변수는 Active Directory의 개체 위치에 따라 결과를 필터링합니다. 지정된 위치에 있는 개체만 반환됩니다. 이 매개 변수에 사용할 수 있는 입력은 Get-OrganizationalUnit cmdlet을 사용하여 표시되는 OU(조직 구성 단위) 또는 도메인입니다. OU 또는 도메인을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- 이름
- DN(고유 이름)
- GUID
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PrimarySmtpAddress
적용 가능: Exchange Online
PrimarySmtpAddress는 기본 SMTP 전자 메일 주소(예 navin@contoso.com: )로 보려는 받는 사람을 식별합니다.
Anr, ExternalDirectoryObjectId, Identity 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Properties
적용 가능: Exchange Online
Properties 매개 변수는 이 cmdlet의 출력에 반환되는 속성을 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
사용 가능한 속성에 대한 자세한 내용은 Get-EXORecipient 속성 집합을 참조하세요.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PropertySets
적용 가능: Exchange Online
PropertySets 매개 변수는 이 cmdlet의 출력에 반환되는 속성의 논리적 그룹화 를 지정합니다. 유효한 값은 다음과 같습니다.
- 최소값(기본값)
- 보관
- 사용자 지정
- MailboxMove
- 정책
각 속성 집합에 포함된 속성에 대한 자세한 내용은 Get-EXORecipient 속성 집합을 참조하세요.
매개 변수 속성
| 형식: | PropertySet[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RecipientPreviewFilter
적용 가능: Exchange Online
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RecipientType
적용 가능: Exchange Online
RecipientType 매개 변수는 지정된 받는 사람 유형별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.
- DynamicDistributionGroup
- MailContact
- MailNonUniversalGroup
- MailUniversalDistributionGroup
- MailUniversalSecurityGroup
- MailUser
- PUBLICFOLDER
- UserMailbox
쉼표로 구분하여 여러 값을 지정할 수 있습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RecipientTypeDetails
적용 가능: Exchange Online
RecipientTypeDetails 매개 변수는 지정된 받는 사람 하위 형식으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.
- DiscoveryMailbox
- DynamicDistributionGroup
- EquipmentMailbox
- GroupMailbox
- GuestMailUser
- LegacyMailbox
- LinkedMailbox
- LinkedRoomMailbox
- MailContact
- MailForestContact
- MailNonUniversalGroup
- MailUniversalDistributionGroup
- MailUniversalSecurityGroup
- MailUser
- PUBLICFOLDER
- PublicFolderMailbox
- RemoteEquipmentMailbox
- RemoteRoomMailbox
- RemoteSharedMailbox
- RemoteTeamMailbox
- RemoteUserMailbox
- RoomList
- RoomMailbox
- SchedulingMailbox
- SharedMailbox
- SharedWithMailUser
- TeamMailbox
- UserMailbox
쉼표로 구분하여 여러 값을 지정할 수 있습니다.
RecipientType 매개 변수의 값은 이 매개 변수에 사용할 수 있는 값에 영향을 줍니다. 예를 들어 RecipientType 값 MailContact를 사용하는 경우 이 매개 변수에 UserMailbox 값을 사용할 수 없습니다. 지정된 RecipientTypeDetails 중 어느 것도 지정된 받는 사람 유형에 포함되지 않습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Online
ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UserPrincipalName
적용 가능: Exchange Online
UserPrincipalName 매개 변수는 UPN(예 navin@contoso.onmicrosoft.com: )으로 보려는 받는 사람을 식별합니다.
Anr, ExternalDirectoryObjectId, Identity 또는 PrimarySmtpAddress 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.