Exchange PowerShell 명령의 수신자 필터

Exchange 관리 셸 및 Exchange Online PowerShelll의 cmdlet은 받는 사람 관련 cmdlet에서 다양한 유형의 필터를 지원합니다.

• 미리 검사된 필터입니다.
• RecipientFilter 매개 변수를 사용하는 사용자 지정 필터입니다.
• Filter 매개 변수를 사용하는 사용자 지정 필터입니다.
• ContentFilter 매개 변수를 사용하는 사용자 지정 필터입니다.

이전 버전의 Exchange에서는 LDAP 필터링 구문을 사용하여 사용자 지정 주소 목록, URL(전역 주소 목록), 전자 메일 주소 정책 및 메일 그룹을 만들었습니다. OPATH 필터링 구문은 2007년 Exchange Server LDAP 필터링 구문을 대체했습니다.

미리 만든 필터

미리 검색된 필터는 Exchange에서 인기 있는 속성을 사용하여 동적 메일 그룹, 이메일 주소 정책, 주소 목록 또는 URL에 대한 받는 사람을 필터링합니다. 미리 검색된 필터를 사용하면 Exchange PowerShell 또는 EAC(Exchange 관리 센터)를 사용할 수 있습니다. 미리 검색된 필터를 사용하여 다음 작업을 수행할 수 있습니다.

• 받는 사람 범위를 결정합니다.
• 회사, 부서, 주 또는 지역과 같은 일반적인 속성에 따라 조건부 필터링을 추가합니다.
• 받는 사람에 대한 사용자 지정 특성을 추가합니다. 자세한 내용은 사용자 지정 특성을 참조하세요.

다음 매개 변수는 미리 만든 필터로 간주됩니다.

• IncludedRecipients
• ConditionalCompany
• ConditionalDepartment
• ConditionalStateOrProvince
• ConditionalCustomAttribute1에서 ConditionalCustomAttribute15로.

미리 검색된 필터는 다음 cmdlet에서 사용할 수 있습니다.

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

미리 검사된 필터 예제

이 예제에서는 Exchange 관리 셸에서 미리 검색된 필터를 사용하여 동적 메일 그룹을 만드는 방법을 설명합니다. 이 예의 구문은 전자 메일 주소 정책, 주소 목록 또는 GAL을 만들 때 사용하는 구문과 유사하지만 동일하지는 않습니다. 미리 만든 필터의 경우 만들 때 다음 사항을 확인해야 합니다.

• 받는 사람( RecipientContainer 매개 변수)을 포함하려는 OU(조직 구성 단위)는 무엇인가요?

  참고

  이 목적을 위해 OU를 선택하는 것은 동적 메일 그룹을 만드는 데만 적용되며 전자 메일 주소 정책, 주소 목록 또는 URL을 만드는 데는 적용되지 않습니다.

• 포함할 받는 사람 유형( IncludedRecipients 매개 변수)은 무엇인가요?

• 필터에 포함하려는 추가 조건( ConditionalCompany, ConditionalDepartment, ConditionalStateOrProvince 및 ConditionalCustomAttribute 매개 변수)은 무엇인가요?

이 예제에서는 다음 속성을 사용하여 동적 메일 그룹을 만듭니다.

• 이름: Contoso Finance.
• 받는 사람 유형: 사용자 사서함.
• 받는 사람 위치: Contoso.com/Users 라는 OU입니다.
• 필터 Finance로 정의된 Department 특성과 Contoso로 정의된 회사 특성이 있는 받는 사람만 포함합니다.

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

이 예에서는 이 새 동적 메일 그룹의 속성을 표시합니다.

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

RecipientFilter 매개 변수를 사용하는 사용자 지정 필터

미리 검색된 필터가 요구 사항을 충족하지 않는 경우 RecipientFilter 매개 변수를 사용하여 사용자 지정 필터를 만들 수 있습니다. 이 매개 변수는 다음 cmdlet에서 사용할 수 있습니다.

• New-DynamicDistributionGroup

• Set-DynamicDistributionGroup

• New-EmailAddressPolicy

• Set-EmailAddressPolicy

• New-AddressList

• Set-AddressList

• New-GlobalAddressList

• Set-GlobalAddressList

RecipientFilter 매개 변수와 함께 사용할 수 있는 필터링 가능한 속성에 대한 자세한 내용은 RecipientFilter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.

사용자 지정 필터 예제

다음 예에서는 RecipientFilter 매개 변수를 사용하여 동적 메일 그룹을 만듭니다. 이 예의 구문은 전자 메일 주소 정책, 주소 목록 또는 GAL을 만들 때 사용하는 구문과 유사하지만 동일하지는 않습니다.

이 예제에서는 사용자 지정 필터를 사용하여 다음 속성을 사용하여 동적 메일 그룹을 만듭니다.

• 이름: AllContosoNorth.
• 받는 사람 유형: 사용자 사서함.
• 받는 사람 위치: Contoso.com/Users 라는 OU입니다.
• 필터회사 특성이 Contoso로 정의되고 Office 특성이 North Building으로 정의된 받는 사람만 포함합니다.

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

Filter 매개 변수를 사용하는 사용자 지정 필터

Filter 매개 변수를 사용하여 명령 결과를 필터링하여 검색할 개체를 지정할 수 있습니다. 예를 들어 모든 사용자 또는 그룹을 검색하는 대신 필터 문자열을 사용하여 사용자 또는 그룹 집합을 지정할 수 있습니다. 이러한 유형의 필터는 개체의 구성이나 특성을 수정하지 않습니다. 명령에서 반환하는 개체 집합만 수정합니다.

Filter 매개 변수를 사용하여 명령 결과를 수정하는 것을 서버 쪽 필터링이라고 합니다. 서버 쪽 필터링은 명령과 필터를 처리하도록 서버로 전송합니다. 또한 명령이 서버에서 모든 개체를 검색한 다음 로컬 콘솔 창에 필터를 적용하는 클라이언트 쪽 필터링도 지원합니다. 클라이언트 쪽 필터링을 수행하려면 Where-Object cmdlet를 사용합니다. 서버 쪽 필터링과 클라이언트 쪽 필터링에 대한 자세한 내용은 Working with Command Output의 "데이터 필터링 방법"을 참조하십시오.

Filter 매개 변수를 포함하는 cmdlet의 필터링할 수 있는 속성을 찾으려면 개체에 대해 Get 명령을 실행하고 Format-List 매개 변수를 파이프라인하여 출력 형식을 지정할 수 있습니다. 반환된 값의 대부분은 Filter 매개 변수에서 사용할 수 있습니다.

다음 예에서는 사서함 Ayla의 세부 목록을 반환합니다.

Get-Mailbox -Identity Ayla | Format-List

Filter 매개 변수는 다음 받는 사람 cmdlet에 사용할 수 있습니다.

• Get-CASMailbox
• Get-Contact
• Get-DistributionGroup
• Get-DynamicDistributionGroup
• Get-Group
• Get-Mailbox
• Get-MailContact
• Get-MailPublicFolder
• Get-MailUser
• Get-Recipient
• Get-RemoteMailbox
• Get-SecurityPrincipal
• Get-UMMailbox
• Get-User
• Get-UnifiedGroup

Filter 매개 변수와 함께 사용할 수 있는 필터링 가능한 속성에 대한 자세한 내용은 Filter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.

필터 매개 변수 예제

이 예제에서는 Filter 매개 변수를 사용하여 제목에 "manager"라는 단어가 포함된 사용자에 대한 정보를 반환합니다.

Get-User -Filter "Title -like 'Manager*'"

ContentFilter 매개 변수를 사용하는 사용자 지정 필터

New-MailboxExportRequest cmdlet을 사용할 경우 ContentFilter 매개 변수를 사용하여 내보낼 특정 메시지 콘텐츠를 선택할 수 있습니다. 이 명령이 콘텐츠 필터에 일치하는 대상이 포함된 메시지를 찾으면 해당 메시지를 .pst 파일로 내보냅니다.

ContentFilter 매개 변수 예제

이 예제에서는 본문에 "회사 잠재 고객"이라는 문구가 포함된 메시지를 Ayla의 사서함을 검색하는 내보내기 요청을 만듭니다. 해당 구가 발견되면 명령은 해당 구가 있는 모든 메시지를 .pst 파일로 내보냅니다.

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

ContentFilter 매개 변수와 함께 사용할 수 있는 필터링 가능한 속성에 대한 자세한 내용은 ContentFilter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.

추가 OPATH 구문 정보

사용자 지정 OPATH 필터를 만들 때 다음 항목을 고려합니다.

• 다음 구문을 사용하여 검색하는 값 유형을 식별합니다.

  • 텍스트 값: 텍스트를 작은따옴표(예: 또는 'Value with spaces')로 'Value' 묶습니다. 또는 텍스트 값을 큰따옴표로 묶을 수 있지만 전체 OPATH 필터를 묶는 데 사용할 수 있는 문자가 제한됩니다.

  • 변수: 작은따옴표(예 '$User': )로 확장해야 하는 변수를 묶습니다. 변수 값 자체에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를 '$User'사용합니다 '$($User -Replace "'","''")'.

  • 정수 값: 정수(예 500: )를 묶을 필요가 없습니다. 정수를 작은따옴표나 큰따옴표로 묶을 수 있지만 전체 OPATH 필터를 묶는 데 사용할 수 있는 문자는 제한됩니다.

  • 시스템 값: 시스템 값(예 $true: , $false또는 $null)을 묶지 마세요. 전체 OPATH 필터를 큰따옴표로 묶려면 달러 로그인 시스템 값(예: `$true)을 이스케이프해야 합니다.

• 전체 OPATH 필터를 큰따옴표 " " 또는 작은따옴표 ' '로 묶어야 합니다. OPATH 필터 개체는 기술적으로 스크립트 블록이 아닌 문자열이지만, 필터에 확장이 필요한 변수가 없는 경우에만 중괄호 { }를 사용할 수 있습니다. 전체 OPATH 필터를 묶는 데 사용할 수 있는 문자는 검색하는 값 형식과 해당 값을 묶는 데 사용했거나 사용하지 않은 문자에 따라 달라집니다.

  • 텍스트 값: 검색할 텍스트를 묶는 방법에 따라 달라집니다.

    • 작은따옴표로 묶인 텍스트: 전체 OPATH 필터를 큰따옴표 또는 중괄호로 묶습니다.
    • 큰따옴표로 묶인 텍스트: 전체 OPATH 필터를 중괄호로 묶습니다.

  • 변수: 전체 OPATH 필터를 큰따옴표(예: "Name -eq '$User'")로 묶습니다.

  • 정수 값: 검색할 정수를 묶거나 묶지 않은 방법에 따라 달라집니다.

    • 묶지 않은 정수: 전체 OPATH 필터를 큰따옴표, 작은따옴표 또는 중괄호(예 "CountryCode -eq 840": )로 묶습니다.
    • 작은따옴표로 묶인 정수: 전체 OPATH 필터를 큰따옴표 또는 중괄호로 묶습니다 "CountryCode -eq '840'".
    • 큰따옴표로 묶인 정수: 전체 OPATH 필터를 중괄호로 묶습니다(예 {CountryCode -eq "840"}: ).

  • 시스템 값: 전체 OPATH 필터를 작은따옴표 또는 중괄호(예 'HiddenFromAddressListsEnabled -eq $true': )로 묶습니다. 달러 기호 시스템 값을 이스케이프하는 경우 전체 OPATH 필터를 큰따옴표(예 "HiddenFromAddressListsEnabled -eq `$true": )로 묶을 수도 있습니다.

  검색 조건과 전체 OPATH 필터를 묶는 데 사용할 수 있는 유효한 문자의 호환성은 다음 표에 요약되어 있습니다.

  검색 값	OPATH 필터 으로 묶인 큰따옴표	OPATH 필터 으로 묶인 작은따옴표	OPATH 필터는 다음으로 묶입니다. 중괄호
  'Text'	✔		✔
  "Text"			✔
  '$Variable'	✔
  500	✔	✔	✔
  '500'	✔		✔
  "500"			✔
  $true		✔	✔
  `$true	✔	✔	✔

• 모든 논리 또는 비교 연산자 앞에 하이픈을 포함합니다. 가장 일반적인 연산자는 다음과 같습니다.

  • -and
  • -or
  • -not
  • -eq (같음)
  • -ne (같지 않음)
  • -lt (보다 작음)
  • -gt (보다 큼)
  • -like (문자열 비교)
  • -notlike (문자열 비교)

• 많은 필터링 가능한 속성은 와일드카드 문자를 허용합니다. 와일드카드 문자를 사용하는 경우 -eq 연산자 대신 -like 연산자를 사용합니다. -like 연산자를 사용하여 서식 있는 형식(예: 문자열)에서 패턴 일치 항목을 찾습니다. -eq 연산자를 사용하여 정확한 일치 항목을 찾습니다.

  Exchange Online PowerShell에서 -like 연산자를 사용하는 경우 와일드카드 문자는 대부분의 매개 변수에서 접미사로만 지원됩니다. 예를 들어 는 "Department -like 'sales*'" 허용되지만 "Department -like '*sales'" 허용되지 않습니다.

  팁

  와일드카드 접두사는 Exchange Online PowerShell의 필터 매개 변수에서 작동하는 경우에도 낮은 성능 문제로 인해 사용하지 않는 것이 좋습니다.

• 사용할 수 있는 연산자에 대한 자세한 내용은 다음을 참조하세요.

  • about_Logical_Operators
  • about_Comparison_Operators

받는 사람 필터 설명서

다음 표에는 Exchange 받는 사람 명령과 함께 사용할 수 있는 필터링 가능한 속성에 대해 자세히 알아볼 수 있는 문서에 대한 링크가 포함되어 있습니다.