Set-ComplianceSecurityFilter
이 cmdlet은 보안 & 규정 준수 PowerShell에서만 작동합니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Set-ComplianceSecurityFilter cmdlet을 사용하여 Microsoft Purview 규정 준수 포털 규정 준수 보안 필터를 수정합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Set-ComplianceSecurityFilter
-FilterName <String>
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-Description <String>]
[-Filters <MultiValuedProperty>]
[-Region <String>]
[-Users <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
예제
예 1
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.add("pilarp@contoso.com")
Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users
이 예제에서는 필터에 할당된 다른 사용자에게 pilarp@contoso.com 영향을 주지 않고 Ottawa 사용자 필터라는 규정 준수 보안 필터에 사용자를 추가합니다.
예 2
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.remove("annb@contoso.com")
Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users
이 예제에서는 필터에 할당된 다른 사용자에게 annb@contoso.com 영향을 주지 않고 Ottawa Users Filter라는 규정 준수 보안 필터에 사용자를 제거합니다.
매개 변수
-Action
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
Action 매개 변수는 필터가 적용되는 검색 작업의 유형을 지정합니다. 이 매개 변수의 유효한 값은 All입니다. 즉, 필터가 모든 검색 작업에 적용됩니다.
- 내보내기: 검색 결과를 내보내거나 eDiscovery Premium에서 분석을 준비할 때 필터가 적용됩니다.
- 미리 보기: 검색 결과를 미리 볼 때 필터가 적용됩니다.
- 제거: 검색 결과를 제거할 때 필터가 적용됩니다. 항목 삭제 방법은 New-ComplianceSearchAction cmdlet의 PurgeType 매개 변수 값에 의해 제어됩니다. 기본값은 SoftDelete입니다. 즉, 삭제된 항목 보존 기간이 만료될 때까지 제거된 항목을 사용자가 복구할 수 있습니다.
- 검색: 검색을 실행할 때 필터가 적용됩니다.
- Search: 검색을 실행할 때 필터가 적용됩니다.
매개 변수 속성
| 형식: | ComplianceSecurityFilterActionType |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Description
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
Description 매개 변수는 규정 준수 보안 필터에 대한 설명을 지정합니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-FilterName
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
FilterName 매개 변수는 수정하려는 준수 보안 필터의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Filters
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
Filters 매개 변수는 준수 보안 필터의 검색 조건을 지정합니다. 다음과 같은 세 가지 유형의 필터를 만들 수 있습니다.
- 사서함 필터: 할당된 사용자가 검색할 수 있는 사서함을 지정합니다. 유효한 구문은 입니다
Mailbox_<MailboxPropertyName>. 여기서<MailboxPropertyName>은 사서함 속성 값입니다. 예를 들어 사용자는"Mailbox_CustomAttribute10 -eq 'OttawaUsers'"CustomAttribute10 속성에서 값이 OttawaUsers인 사서함만 검색할 수 있습니다. 지원되는 사서함 속성 목록은 RecipientFilter 매개 변수에 대한 필터링 가능한 속성을 참조하세요. - 사서함 콘텐츠 필터: 할당된 사용자가 검색할 수 있는 사서함 콘텐츠를 지정합니다. 유효한 구문은 입니다. 여기서
<SearchablePropertyName>준수MailboxContent_<SearchablePropertyName>검색에 지정할 수 있는 KQL(키워드 쿼리 언어) 속성을 지정합니다. 예를 들어 사용자는"MailboxContent_Recipients -like 'contoso.com'"contoso.com 도메인의 받는 사람에게 보낸 메시지만 검색할 수 있습니다. 검색 가능한 전자 메일 속성 목록은 eDiscovery에 대한 키워드 쿼리를 참조하세요. - 사이트 및 사이트 콘텐츠 필터: 만들
Site_<SearchableSiteProperty>수 있는 두 개의 SharePoint 및 OneDrive 사이트 관련 필터가 있습니다( 사이트 관련 속성을 지정합니다.) 예를 들어 사용자가"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'"사이트 모음의https://contoso.sharepoint.com/sites/doctors콘텐츠만 검색할 수 있도록 허용하고SiteContent_<SearchableSiteProperty>(콘텐츠 관련 속성을 지정합니다.) 예를 들어 사용자는"SiteContent_FileExtension -eq 'docx'"Word 문서)만 검색할 수 있습니다. 검색 가능한 사이트 속성 목록은 SharePoint Server의 크롤링 및 관리 속성 개요를 참조하세요. 쿼리 가능 열에 예가 표시되는 속성은 사이트 또는 사이트 콘텐츠 필터를 만드는 데 사용할 수 있습니다.
동일한 유형의 여러 필터를 지정할 수 있습니다. 예를 들면 "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'"와 같습니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Region
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
Region 매개 변수는 다중 지역 테넌트가 eDiscovery 검색을 수행할 위성 위치를 지정합니다. 유효한 값은 다음과 같습니다.
- APC: Asia-Pacific
- 호주: 오스트레일리아
- CAN: 캐나다
- EUR: 유럽, 중동, 아프리카
- FRA: 프랑스
- GBR: 영국
- IND: 인도
- JPN: 일본
- LAM: 라틴 아메리카
- NAM: 북아메리카
다중 지역 테넌트에서 이 매개 변수를 사용하지 않으면 eDiscovery 검색이 중앙 위치에서 수행됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Users
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
Users 매개 변수는 검색에 적용된 이 필터를 받는 사용자를 지정합니다. 유효한 값은 다음과 같습니다.
- 하나 이상의 사용자: 별칭 또는 이메일 주소로 사용자를 식별합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
- All: 값은 모든 사용자에게 필터를 할당합니다. 이 값 자체만 사용할 수 있습니다.
- 하나 이상의 역할 그룹: 역할 그룹을 이름으로 식별합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수로 메일 그룹을 지정할 수는 없습니다.
지정한 값은 기존 항목을 덮어씁 수 있습니다. 다른 기존 항목을 영향을 주지 않고 사용자를 추가 또는 제거하려면 예제 섹션을 참조하세요.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수
WhatIf 스위치는 보안 및 준수 PowerShell에서 작동하지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.