Set-ComplianceSecurityFilter

이 cmdlet은 Security & PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 센터 PowerShell을 참조하세요.

Set-ComplianceSecurityFilter cmdlet을 사용하여 Microsoft 365 준수 센터에서 준수 보안 필터를 수정할 수 있습니다.

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

Syntax

Set-ComplianceSecurityFilter
   -FilterName <String>
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-Description <String>]
   [-Filters <MultiValuedProperty>]
   [-Region <String>]
   [-Users <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Security & Compliance Center PowerShell에서 이 cmdlet을 사용하려면 사용 권한을 할당해야 합니다. 자세한 내용은 Microsoft 365 규정 준수 센터의 사용 권한을 참조하세요.

예제

예 1

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.add("pilarp@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

이 예에서는 필터에 할당된 다른 사용자에게 영향을 주지 않고 Ottawa Users Filter라는 준수 보안 필터에 pilarp@contoso.com 사용자를 추가합니다.

예 2

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.remove("annb@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

이 예에서는 필터에 할당된 다른 사용자에게 영향을 주지 않고 Ottawa Users Filter라는 준수 보안 필터에서 annb@contoso.com 사용자를 제거합니다.

매개 변수

-Action

Action 매개 변수는 필터가 적용되는 검색 작업 유형을 지정합니다. 유효한 값은 다음과 같습니다.

  • 내보내기: 필터는 검색 결과를 내보내거나 검색 결과에서 분석을 준비할 때 Microsoft 365 Advanced eDiscovery.
  • 미리 보기: 검색 결과를 미리 볼 때 필터가 적용됩니다.
  • 제거: 필터는 검색 결과를 지우는 경우 적용됩니다. 항목이 삭제되는 방식은 cmdlet의 PurgeType 매개 변수 값에 New-ComplianceSearchAction 제어합니다. 기본값은 SoftDelete입니다. 즉, 삭제된 항목 보존 기간이 만료될 때까지 사용자가 제거된 항목을 복구할 수 있습니다.
  • 검색: 필터는 검색을 실행하면 적용됩니다.
  • Search: 검색을 실행할 때 필터가 적용됩니다.
Type:ComplianceSecurityFilterActionType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
  • 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Description

Description 매개 변수는 규정 준수 보안 필터에 대한 설명을 지정합니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-FilterName

FilterName 매개 변수는 수정하려는 준수 보안 필터의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Filters

Filters 매개 변수는 준수 보안 필터의 검색 조건을 지정합니다. 다음과 같은 세 가지 유형의 필터를 만들 수 있습니다.

  • 사서함 필터: 할당된 사용자가 검색할 수 있는 사서함을 지정합니다. 유효한 구문은 Mailbox_<MailboxPropertyName> 입니다. 여기서 <MailboxPropertyName> 는 사서함 속성 값입니다. 예를 들어 "Mailbox_CustomAttribute10 -eq 'OttawaUsers'" 사용자는 CustomAttribute10 속성에 OttawaUsers 값이 있는 사서함만 검색할 수 있습니다. 지원되는 사서함 속성 목록은 RecipientFilter 매개 변수의 필터링 가능한 속성을 참조하세요.
  • 사서함 콘텐츠 필터: 할당된 사용자가 검색할 수 있는 사서함 콘텐츠를 지정합니다. 유효한 구문은 입니다. 여기서 준수 검색에서 지정할 수 있는 MailboxContent_<SearchablePropertyName>:<value> <SearchablePropertyName> KQL(Keyword Query Language) 속성을 지정합니다. 예를 들어 사용자가 도메인의 받는 사람에게 보낸 메시지만 검색할 MailboxContent_recipients:contoso.com contoso.com 있습니다. 검색 가능한 메시지 속성 목록은 준수 검색에 대한 키워드 쿼리를 참조하세요.
  • 사이트 및 사이트 콘텐츠 필터: 만들 수 있는 두 가지 SharePoint 온라인 및 비즈니스용 OneDrive 관련 필터가 있습니다. (사이트 관련 속성 Site_<SearchableSiteProperty> 지정). 예를 들어 사용자가 사이트 모음의 콘텐츠만 검색할 수 있도록 허용하고 콘텐츠 관련 속성을 "Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'" https://contoso.sharepoint.com/sites/doctors SiteContent_<SearchableSiteProperty> 지정합니다. 예를 들어 Word "SiteContent_FileExtension -eq 'docx'" 문서만 검색할 수 있습니다. 검색 가능한 사이트 속성 목록은 Overview of crawled and managed properties in SharePoint Server를 참조하십시오. 쿼리 가능 열에 예가 표시되는 속성은 사이트 또는 사이트 콘텐츠 필터를 만드는 데 사용할 수 있습니다.

동일한 유형의 여러 필터를 지정할 수 있습니다. 예를 들면 "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'"와 같습니다.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Region

Region 매개 변수는 다중 위치 테넌트가 eDiscovery 검색을 수행하기 위한 위성 위치를 지정합니다. 유효한 값은 다음과 같습니다.

  • APC: Asia-Pacific
  • AUS: 오스트레일리아
  • CAN: Canada
  • EUR: 유럽, 중동, 아프리카
  • FRA: 프랑스
  • GBR: 영국
  • IND: 인도
  • JPN: 일본
  • LAM: 라틴 아메리카
  • NAM: 북아메리카

다중 위치 테넌트에서 이 매개 변수를 사용하지 않는 경우 eDiscovery 검색이 중앙 위치에서 수행됩니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Users

Users 매개 변수는 검색에 적용된 이 필터를 받는 사용자를 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 하나 이상의 사용자: 별칭 또는 전자 메일 주소로 사용자를 식별합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
  • 값 All: 모든 사용자에게 필터를 할당합니다. 이 값 자체만 사용할 수 있습니다.
  • 하나 이상의 역할 그룹: 이름으로 역할 그룹을 식별합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

이 매개 변수로 메일 그룹을 지정할 수는 없습니다.

지정한 값이 기존 항목을 덮어씁니다. 다른 기존 항목을 영향을 주지 않고 사용자를 추가 또는 제거하려면 예제 섹션을 참조하세요.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-WhatIf

WhatIf 스위치는 보안 및 준수 센터 PowerShell에서 작동하지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center

입력

출력