Get-EXORecipient

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Online

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

Get-ExORecipient cmdlet을 사용하여 조직의 기존 받는 사람 개체를 봅니다. 이 cmdlet은 사서함, 메일 사용자, 메일 연락처, 메일 그룹 등 메일 사용이 가능한 모든 개체를 반환합니다.

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

Syntax

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>]
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을 사용하여 조직의 기존 받는 사람 개체를 볼 수 있습니다. 이 cmdlet은 사서함, 메일 사용자, 메일 연락처, 메일 그룹 등 메일 사용이 가능한 모든 개체를 반환합니다.

예제

예 1

Get-EXORecipient -ResultSize 100

다음은 이름 정렬 순서로 처음 100명의 받는 사람 개체를 반환하는 예제입니다.

예 2

Get-EXORecipient -Identity john@contosot.com

이 예제에서는 사용자의 받는 사람 특성 세부 정보를 반환합니다. 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

-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-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 구문 정보를 참조하세요.

Type:String
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

-IncludeSoftDeletedRecipients

IncludeSoftDeletedRecipients 스위치는 일시 삭제된 수신자를 결과에 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

일시 삭제된 받는 사람은 여전히 복구할 수 있는 삭제된 받는 사람입니다.

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-EXORecipient 속성 집합을 참조하세요.

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

-PropertySets

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

  • 최소값(기본값)
  • 보관
  • 사용자 지정
  • MailboxMove
  • 정책

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

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

-RecipientPreviewFilter

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

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

-RecipientType

RecipientType 매개 변수는 지정된 받는 사람 유형별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

  • DynamicDistributionGroup
  • MailContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PUBLICFOLDER
  • UserMailbox

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

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

-RecipientTypeDetails

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가 지정된 받는 사람 유형에 포함되지 않는다는 오류가 표시됩니다.

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

-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