받는 사람 필터 Exchange 관리 셸 명령Recipient filters in Exchange Management Shell commands

필터링 된 받는 사람 집합에 여러 Exchange 관리 셸 명령을 사용할 수 있습니다. Exchange 명령에는 다음과 같은 유형의 필터를 만들 수 있습니다.You can use several Exchange Management Shell commands to filter a set of recipients. You can create the following types of filters in an Exchange command:

  • 미리 만든 필터Precanned filters

  • RecipientFilter 매개 변수를 사용하는 사용자 지정 필터Custom filters using the RecipientFilter parameter

  • Filter 매개 변수를 사용 하 여 사용자 지정 필터Custom filters using the Filter parameter

  • ContentFilter 매개 변수를 사용 하 여 사용자 지정 필터Custom filters using the ContentFilter parameter

사용자 지정 주소 목록, 전체 주소 목록 (Gal), 전자 메일 주소 정책 및 메일 그룹을 만드는 필터링 구문을 LDAP를 사용 하는 이전 버전의 Exchange 합니다. Exchange Server 2007 및 그 이후 버전 필터링 구문을 OPATH 구문을 필터링 하는 LDAP을 바뀌었습니다.Older versions of Exchange used LDAP filtering syntax to create custom address lists, global address lists (GALs), email address policies, and distribution groups. In Exchange Server 2007 and later versions, OPATH filtering syntax replaced LDAP filtering syntax.

미리 만든 필터Precanned filters

미리 만든된 필터는 다양 한 동적 메일 그룹, 전자 메일 주소 정책, 주소 목록 또는 Gal을 만들기 위한 받는 사람 필터링 조건 충족 하기 위해 사용할 수 있는 자주 사용 되는 Exchange 필터입니다. 미리 만든된 필터를 사용 하 여 Exchange 관리 셸 또는 Exchange 관리 센터 (EAC)를 사용할 수 있습니다. 미리 만든된 필터를 사용 하면 다음을 수행할 수 있습니다.A precanned filter is a commonly used Exchange filter that you can use to meet a variety of recipient-filtering criteria for creating dynamic distribution groups, email address policies, address lists, or GALs. With precanned filters, you can use either the Exchange Management Shell or the Exchange admin center (EAC). Using precanned filters, you can do the following:

  • 받는 사람 범위를 결정합니다.Determine the scope of recipients.

  • 회사, 부서 및 국가 또는 지역 같은 속성에 따라 조건부 필터링을 추가합니다.Add conditional filtering based on properties such as company, department, and state or region.

  • 받는 사람에 대 한 사용자 지정 특성을 추가 합니다. 자세한 내용은 사용자 지정 특성을 참조 하십시오.Add custom attributes for recipients. For more information, see Custom Attributes.

다음 매개 변수는 미리 만든 필터로 간주됩니다.The following parameters are considered precanned filters:

  • IncludedRecipientsIncludedRecipients

  • ConditionalCompanyConditionalCompany

  • ConditionalDepartmentConditionalDepartment

  • ConditionalStateOrProvinceConditionalStateOrProvince

  • ConditionalCustomAttribute15_에 _ConditionalCustomAttribute1 을 선택 합니다.ConditionalCustomAttribute1 to ConditionalCustomAttribute15.

미리 만든 필터는 다음 cmdlet에 사용할 수 있습니다.Precanned filters are available for the following cmdlets:

예제Example

이 예제에서는 Exchange 관리 셸에서 미리 만든된 필터를 사용 하 여 동적 메일 그룹을 만듭니다. 이 예제의 구문을 유사 하지만 구문에 동일 하지는 않는 상태인 사용 하 여 전자 메일 주소 정책, 주소 목록이 나 GAL을 만듭니다. 미리 만든된 필터를 만들 때는 다음 질문 해야 합니다.This example describes using precanned filters in the Exchange Management Shell to create a dynamic distribution group. The syntax in this example is similar but not identical to the syntax you would use to create an email address policy, address list, or GAL. When creating a precanned filter, you should ask the following questions:

  • 어떤 OU(조직 단위)의 받는 사람을 포함시키겠습니까? (이 질문은 RecipientContainer 매개 변수에 해당합니다.)From which organizational unit (OU) do you want to include recipients? (This question corresponds to the RecipientContainer parameter.)

Note

선택한 OU는 동적 메일 그룹을 만들 때만 적용되며 전자 메일 주소 정책, 주소 목록 또는 GAL을 만들 때는 적용되지 않습니다.Selecting the OU for this purpose applies only when creating dynamic distribution groups, and not when creating email address policies, address lists, or GALs.

  • 어떤 유형의 받는 사람을 포함시키겠습니까? (이 질문은 IncludedRecipients 매개 변수에 해당합니다.)What type of recipients do you want to include? (This question corresponds to the IncludedRecipients parameter.)

  • 필터에 포함시키려는 추가 조건은 무엇입니까? (이 질문은 ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvinceConditionalCustomAttribute 매개 변수에 해당합니다.)What additional conditions do you want to include in the filter? (This question corresponds to the ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince, and ConditionalCustomAttribute parameters.)

이 예에서는 OU Contoso.com/Users의 사용자 사서함에 대한 동적 메일 그룹 Contoso Finance를 만들고 Department 특성은 Finance로 정의되고 Company 특성은 Contoso로 정의된 받는 사람만 포함시키는 조건을 지정합니다.This example creates the dynamic distribution group Contoso Finance for user mailboxes in the OU Contoso.com/Users and specifies the condition to include only recipients who have the Department attribute defined as Finance and the Company attribute defined as Contoso.

New-DynamicDistributionGroup -Name "Contoso Finance" -OrganizationalUnit Contoso.com/Users -RecipientContainer Contoso.com/Users -IncludedRecipients MailboxUsers -ConditionalDepartment "Finance" -ConditionalCompany "Contoso"

이 예에서는 이 새 동적 메일 그룹의 속성을 표시합니다.This example displays the properties of this new dynamic distribution group.

Get-DynamicDistributionGroup -Identity "Contoso Finance" | Format-List Recipient*,Included*

RecipientFilter 매개 변수를 사용하는 사용자 지정 필터Custom filters using the RecipientFilter parameter

미리 만든 필터가 동적 메일 그룹, 전자 메일 주소 정책 및 주소 목록을 만들거나 수정하는 데 필요한 사항을 충족하지 않을 경우 RecipientFilter 매개 변수를 사용하여 사용자 지정 필터를 만들 수 있습니다.If precanned filters don't meet your needs for creating or modifying dynamic distribution groups, email address policies, and address lists, you can create a custom filter by using the RecipientFilter parameter.

받는 사람 필터 매개 변수는 다음 cmdlet에 사용할 수 있습니다.The recipient filter parameter is available for the following cmdlets:

RecipientFilter 매개 변수와 함께 사용할 수 있는 필터링 할 수 있는 속성에 대 한 자세한 내용은 RecipientFilter 매개 변수에 대 한 필터링 할 수 있는 속성을 참조 하십시오.For more information about the filterable properties you can use with the RecipientFilter parameter, see Filterable properties for the RecipientFilter parameter.

예제Example

다음 예에서는 RecipientFilter 매개 변수를 사용하여 동적 메일 그룹을 만듭니다. 이 예의 구문은 전자 메일 주소 정책, 주소 목록 또는 GAL을 만들 때 사용하는 구문과 유사하지만 동일하지는 않습니다.The following example uses the RecipientFilter parameter to create a dynamic distribution group. The syntax in this example is similar but not identical to the syntax you use to create an email address policy, address list, or GAL.

이 예에서는 사용자 지정 필터를 사용하여 Company 특성은 Contoso로 정의되고 Office 특성은 North Building으로 정의된 사용자 사서함에 대한 동적 메일 그룹을 만들 수 있습니다.This example uses custom filters to create a dynamic distribution group for user mailboxes that have the Company attribute defined as Contoso and the Office attribute defined as North Building.

New-DynamicDistributionGroup -Name AllContosoNorth -OrganizationalUnit contoso.com/Users -RecipientFilter { ((RecipientType -eq 'UserMailbox') -and (Company -eq 'Contoso') -and (Office -eq 'North Building')) }

Filter 매개 변수를 사용하는 사용자 지정 필터Custom filters using the Filter parameter

Filter 매개 변수를 사용하여 명령 결과를 필터링하여 검색할 개체를 지정할 수 있습니다. 예를 들어, 모든 사용자나 그룹을 검색하는 대신 필터 문자열을 사용하여 사용자 또는 그룹 집합을 지정할 수 있습니다. 이러한 유형의 필터는 개체의 구성이나 특성을 수정하지 않습니다. 명령에서 반환하는 개체 집합만 수정합니다.You can use the Filter parameter to filter the results of a command to specify which objects to retrieve. For example, instead of retrieving all users or groups, you can specify a set of users or groups by using a filter string. This type of filter doesn't modify any configuration or attributes of objects. It only modifies the set of objects that the command returns.

Filter 매개 변수를 사용 하 여 결과 필터링 하는 서버쪽 알고 있는 명령을 수정 합니다. 서버쪽 필터링 명령 및 처리를 위해 서버에 필터를 전송합니다. Exchange 관리 셸 필터링도 지원 클라이언트쪽 명령은 서버에서 모든 개체를 검색 한 다음 로컬 콘솔 창에서 필터를 적용 합니다. 클라이언트쪽 필터링을 수행 하려면 Where-object cmdlet을 사용 합니다. 서버측 및 클라이언트측 필터링 하는 방법에 대 한 자세한 내용은 "방법를 데이터 필터링을 참고" 명령 출력 (영문)에 있습니다.Using the Filter parameter to modify command results is known as server-side filtering. Server-side filtering submits the command and the filter to the server for processing. The Exchange Management Shell also supports client-side filtering, in which the command retrieves all objects from the server and then applies the filter in the local console window. To perform client-side filtering, use the Where-Object cmdlet. For more information about server-side and client-side filtering, see "How to Filter Data" in Working with Command Output.

Filter 매개 변수를 포함하는 cmdlet의 필터링할 수 있는 속성을 찾으려면 개체에 대해 Get 명령을 실행하고 Format-List 매개 변수를 파이프라인하여 출력 형식을 지정할 수 있습니다. 반환된 값은 대부분 Filter 매개 변수에서 사용할 수 있습니다. 다음 예에서는 사서함 Ayla의 세부 목록을 반환합니다.To find the filterable properties for cmdlets that have the Filter parameter, you can run the Get command against an object and format the output by pipelining the Format-List parameter. Most of the returned values will be available for use in the Filter parameter. The following example returns a detailed list for the mailbox Ayla.

Get-Mailbox -Identity Ayla | Format-List

Filter 매개 변수는 다음 받는 사람 cmdlet에 대 한 제공 됩니다.The Filter parameter is available for the following recipient cmdlets:

Filter 매개 변수와 함께 사용할 수 있는 필터링 할 수 있는 속성에 대 한 자세한 내용은 Filter 매개 변수에 대 한 필터링 할 수 있는 속성을 참조 하십시오.For more information about the filterable properties you can use with the Filter parameter, see Filterable properties for the Filter parameter.

예제Example

이 예에서는 Filter 매개 변수를 사용하여 직함에 "관리자"라는 단어가 포함된 사용자에 대한 정보를 반환합니다.This example uses the Filter parameter to return information about users whose title contains the word "manager".

Get-User -Filter {Title -like 'Manager*'}

ContentFilter 매개 변수를 사용하는 사용자 지정 필터Custom filters using the ContentFilter parameter

New-MailboxExportRequest cmdlet을 사용할 경우 ContentFilter 매개 변수를 사용하여 내보낼 특정 메시지 콘텐츠를 선택할 수 있습니다. 이 명령이 콘텐츠 필터에 일치하는 대상이 포함된 메시지를 찾으면 해당 메시지를 .pst 파일로 내보냅니다.You can use the ContentFilter parameter to select specific message content to export when using the New-MailboxExportRequest cmdlet. If the command finds a message that contains the match to the content filter, it exports the message to a .pst file.

Example

이 예에서는 Ayla의 사서함에서 본문에 "회사 투자 설명서"라는 구가 포함된 메시지를 검색하는 내보내기 요청을 만듭니다. 일치하는 구가 있으면 명령이 해당 구를 포함하는 모든 메시지를 .pst 파일로 내보냅니다.This example creates an export request that searches Ayla's mailbox for messages where the body contains the phrase "company prospectus". If that phrase is found, the command exports all messages with that phrase to a .pst file.

New-MailboxExportRequest -Mailbox Ayla -ContentFilter {Body -like "company prospectus*"}

ContentFilter 매개 변수와 함께 사용할 수 있는 필터링 할 수 있는 속성에 대 한 자세한 내용은 ContentFilter 매개 변수에 대 한 필터링 할 수 있는 속성을 참조 하십시오.For more information about the filterable properties you can use with the ContentFilter parameter, see Filterable Properties for the ContentFilter Parameter.

추가 OPATH 구문 정보Additional OPATH syntax information

자체 사용자 지정 필터를 만들 경우 다음 사항을 고려해야 합니다.When creating your own custom filters, be aware of the following:

  • 사용 하 여 중괄호 Filter 또는 RecipientFilter 매개 변수를 사용 하는 전체 OPATH 필터 문자열 주위 {}입니다.Use braces { } around the entire OPATH filter string with the Filter or RecipientFilter parameters.

  • 모든 연산자 앞에 하이픈을 포함시킵니다. 가장 일반적인 연산자는 다음과 같습니다.Include the hyphen before all operators. The most common operators include:

    • -및-and

    • -또는-or

    • -하지-not

    • -eq(같음)-eq (equals)

    • -ne(같지 않음)-ne (not equal)

    • -lt(보다 작음)-lt (less than)

    • -gt(보다 큼)-gt (greater than)

    • -like(문자열 비교)-like (string comparison)

    • -notlike(문자열 비교)-notlike (string comparison)

  • 다양 한 RecipientFilter필터 매개 변수를 실행 하는 것에 대 한 속성에는 와일드 카드 문자 허용 합니다. 와일드 카드 문자를 사용 하는 경우 like 연산자는 eq 연산자 대신 사용 합니다. Like 연산자는 eq 연산자를 정확 하 게 일치 하는 값을 찾는데 사용 되는 반면 문자열 등의 다양 한 형식을에서 일치 하는 패턴을 찾는 데 사용 됩니다.Many of the properties for the RecipientFilter and Filter parameters accept wildcard characters. If you use a wildcard character, use the like operator instead of the eq operator. The like operator is used to find pattern matches in rich types, such as strings, whereas the eq operator is used to find an exact match.

  • 사용할 수 있는 연산자에 대 한 자세한 내용은 참조 하십시오.For more information about operators you can use, see:

받는 사람 필터 설명서Recipient filter documentation

다음 표에는 Exchange 받는 사람 명령과 함께 사용할 수 있는 필터링할 수 있는 속성에 대해 자세히 설명된 항목에 대한 링크가 포함되어 있습니다.The following table contains links to topics that will help you learn more about the filterable properties that you can use with Exchange recipient commands.

항목Topic 설명Description
RecipientFilter 매개 변수에 대 한 필터링 할 수 있는 속성Filterable properties for the RecipientFilter parameter RecipientFilter 매개 변수의 필터링할 수 있는 속성에 대해 자세히 알아봅니다.Learn more about the filterable properties for the RecipientFilter parameter.
Filter 매개 변수에 대 한 필터링 할 수 있는 속성Filterable properties for the Filter parameter Filter 매개 변수의 필터링할 수 있는 속성에 대해 자세히 알아봅니다.Learn more about the filterable properties for the Filter parameter.