다음을 통해 공유


Get-Recipient

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

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

참고: Exchange Online PowerShell에서는 이 cmdlet 대신 Get-EXORecipient cmdlet을 사용하는 것이 좋습니다. 자세한 내용은 원격 PowerShell을 사용하여 Exchange Online에 연결을 참조하세요.

클라우드 환경에서 Microsoft 365 그룹 반환하려면 RecipientTypeDetails 매개 변수를 GroupMailbox 값과 함께 사용해야 합니다.

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

Syntax

Get-Recipient
   [-Anr <String>]
   [-AuthenticationType <AuthenticationType>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-Capabilities <MultiValuedProperty>]
   [-Database <DatabaseIdParameter>]
   [-Properties <String[]>]
   [-IncludeSoftDeletedRecipients]
   [<CommonParameters>]
Get-Recipient
   [[-Identity] <RecipientIdParameter>]
   [-AuthenticationType <AuthenticationType>]
   [-BookmarkDisplayName <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-IncludeBookmarkObject <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-Capabilities <MultiValuedProperty>]
   [-Properties <String[]>]
   [-IncludeSoftDeletedRecipients]
   [<CommonParameters>]
Get-Recipient
   [-Database <DatabaseIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Properties <String[]>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-IncludeSoftDeletedRecipients] [<CommonParameters>]
   [<CommonParameters>]
Get-Recipient
   [-RecipientPreviewFilter <String>]
   [-AuthenticationType <AuthenticationType>]
   [-Capabilities <MultiValuedProperty>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-IncludeSoftDeletedRecipients]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Properties <String[]>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Description

Get-Recipient cmdlet은 받는 사람에 대한 개체 관련 속성을 모두 반환하지 않을 수도 있습니다. 받는 사람에 대한 개체 관련 속성을 보려면 Get-Mailbox, Get-MailUser 또는 Get-DistributionGroup과 같이 개체 유형을 기반으로 하는 해당 cmdlet을 사용해야 합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-Recipient -ResultSize unlimited

이 예에서는 조직 내 모든 받는 사람의 요약 목록을 검색합니다.

예 2

Get-Recipient -Identity "Marketing Department" | Format-List

이 예제에서는 마케팅 부서라는 받는 사람에 대한 자세한 정보를 반환합니다.

예 3

Get-Recipient -RecipientType MailContact -SortBy Office | Format-Table -Auto Office,Name

이 예에서는 조직의 모든 메일 연락처에 대한 정보를 검색하고 사무실순으로 정렬합니다.

매개 변수

-Anr

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

  • CommonName(CN)
  • DisplayName
  • FirstName
  • LastName
  • 별칭
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-AuthenticationType

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

AuthenticationType 매개 변수는 인증 유형별로 받는 사람을 지정합니다. 다음 값 중 하나를 사용합니다.

  • 페더레이션
  • 관리
Type:AuthenticationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-BookmarkDisplayName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-Capabilities

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

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Credential

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

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

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

Database 매개 변수는 지정된 사서함 데이터베이스에 저장된 모든 받는 사람을 반환합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

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

  • 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
  • 속성은 필터링 가능한 속성입니다. Exchange 서버 및 Exchange Online 필터링 가능한 속성에 대한 자세한 내용은 Filter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.
  • 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

Identity 매개 변수는 보려는 받는 사람 개체를 지정합니다. 받는 사람을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • 정식 DN
  • GUID
Type:RecipientIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-IgnoreDefaultScope

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

IgnoreDefaultScope 스위치는 명령에 Exchange PowerShell 세션의 기본 받는 사람 범위 설정을 무시하고 전체 포리스트를 범위로 사용하도록 지시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 명령이 기본 범위에서 현재 사용할 수 없는 Active Directory 개체에 액세스할 수 있지만 다음과 같은 제한 사항도 도입됩니다.

  • DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.
  • DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeBookmarkObject

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-IncludeSoftDeletedRecipients

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

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

참고: Identity 또는 RecipientTypeDetails 매개 변수와 함께 이 스위치를 사용하여 SoftDeletedRecipients를 가져옵니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationalUnit

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

  • 이름
  • 이름
  • DN(고유 이름)
  • GUID
Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Properties

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-PropertySet

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

Type:PropertySet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-ReadFromDomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

ReadFromDomainController 스위치는 사용자 도메인의 도메인 컨트롤러에서 정보를 읽도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

명령: Set-AdServerSettings -ViewEntireForest $true 포리스트에 모든 개체를 포함하려면 ReadFromDomainController 스위치가 필요합니다. 그렇지 않으면 명령은 오래된 정보가 포함된 글로벌 카탈로그를 사용할 수 있습니다. 또한 ReadFromDomainController 스위치를 사용하여 명령의 여러 반복을 실행하여 정보를 가져와야 할 수도 있습니다.

기본적으로 수신자 범위는 Exchange 서버를 호스트하는 도메인으로 설정됩니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RecipientPreviewFilter

RecipientPreviewFilter 매개 변수는 동적 메일 그룹, 주소 목록 또는 전자 메일 주소 정책에서 사용할 받는 사람 필터를 테스트합니다. 이 매개 변수는 LDAP 필터 구문을 사용합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-RecipientType

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

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

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

Type:RecipientType[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-RecipientTypeDetails

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

  • DiscoveryMailbox
  • DynamicDistributionGroup
  • EquipmentMailbox
  • GroupMailbox(Exchange 2013 이상 및 클라우드)
  • GuestMailUser(Exchange 2016 이상 및 클라우드)
  • LegacyMailbox
  • LinkedMailbox
  • LinkedRoomMailbox(Exchange 2013 이상 및 클라우드)
  • MailContact
  • MailForestContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PUBLICFOLDER
  • PublicFolderMailbox(Exchange 2013 이상 및 클라우드)
  • RemoteEquipmentMailbox
  • RemoteRoomMailbox
  • RemoteSharedMailbox
  • RemoteTeamMailbox(Exchange 2013 이상 및 클라우드)
  • RemoteUserMailbox
  • RoomList
  • RoomMailbox
  • SchedulingMailbox(Exchange 2016 이상 및 클라우드)
  • SharedMailbox
  • SharedWithMailUser(클라우드에만 해당)
  • TeamMailbox(Exchange 2013 이상 및 클라우드)
  • UserMailbox

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

RecipientType 매개 변수의 값은 이 매개 변수에 사용할 수 있는 값에 영향을 줍니다. 예를 들어 RecipientType 값 MailContact를 사용하는 경우 이 매개 변수에 UserMailbox 값을 사용할 수 없습니다. 지정된 RecipientTypeDetails가 지정된 받는 사람 유형에 포함되지 않는다는 오류가 표시됩니다.

Type:RecipientTypeDetails[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

-SortBy

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

기본 보기에 정렬하는 속성이 포함되지 않은 경우 명령을 로 | Format-Table -Auto Property1,Property2,...PropertyX추가할 수 있습니다. 보려는 모든 속성이 포함된 새 뷰를 만듭니다. 속성 이름에 와일드카드(*)를 사용할 수 있습니다.

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

  • 이름
  • DisplayName
  • 별칭
  • 구/군/시
  • FirstName
  • LastName
  • Office
  • ServerLegacyDN
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

입력

Input types

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

출력

Output types

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