Set-QuarantinePolicy

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Online, Exchange Online Protection

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Set-QuarantinePolicy cmdlet을 사용하여 클라우드 기반 organization 격리 정책을 수정합니다.

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

Syntax

Set-QuarantinePolicy
   [-Identity] <QuarantineTagIdParameter>
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-Confirm]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-IgnoreDehydratedFlag]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

AdminOnlyAccessPolicy 또는 DefaultFullAccessPolicy라는 기본 제공 격리 정책은 수정할 수 없습니다.

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

예제

예 1

Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1

이 예제에서는 사용자가 격리된 메시지만 삭제할 수 있도록 CustomAccess라는 격리 정책의 권한을 구성합니다.

예 2

Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息，请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00

이 예제에서는 격리 알림(이전의 최종 사용자 스팸 알림 설정)에 대한 전역 설정을 수정합니다.

  • 격리 알림은 영어, 중국어 및 프랑스어에 맞게 사용자 지정됩니다. 프랑스어 MultiLanguageCustomDisclaimer 값에는 텍스트의 따옴표 문자에 대한 이스케이프 문자로 추가 따옴표가 필요합니다.
  • 기존 사용자는 aashutosh@contso.onmicrosoft.com 격리 알림 보낸 사람으로 사용됩니다.
  • 이전에 구성된 사용자 지정 로고는 기본 Microsoft 로고를 대체합니다.
  • 격리 알림의 빈도는 4시간으로 변경됩니다.

매개 변수

-AdminNotificationFrequencyInDays

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

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

-AdminNotificationLanguage

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

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

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

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

-AdminQuarantinePermissionsList

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

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

-Confirm

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

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

-CustomDisclaimer

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

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

-DomainController

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

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

-EndUserQuarantinePermissions

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

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

-EndUserQuarantinePermissionsValue

EndUserQuarantinePermissionsValue 매개 변수는 격리 정책에 대한 최종 사용자 권한을 지정합니다.

이 매개 변수는 이진 값에서 변환된 10진수 값을 사용합니다. 이진 값은 특정 순서로 사용 가능한 권한 목록에 해당합니다. 각 권한에 대해 값 1은 True이고 값 0은 False와 같습니다. 필수 순서는 다음 목록에서 가장 높음(1000000 또는 128)에서 최저(00000001 또는 1)로 설명합니다.

  • PermissionToViewHeader: 값 0은 격리에서 메시지 헤더 보기 작업을 숨기지 않습니다. 메시지가 격리에 표시되는 경우 메시지에 대해 항상 작업을 사용할 수 있습니다.
  • PermissionToDownload: 이 권한은 사용되지 않습니다(값 0 또는 1은 아무 작업도 수행하지 않음).
  • PermissionToAllowSender: 이 권한은 사용되지 않습니다(값 0 또는 1은 아무 작업도 수행하지 않음).
  • PermissionToBlockSender
  • PermissionToRequestRelease: 이 권한 및 PermissionToRelease를 값 1로 설정하지 마세요. 한 값을 1로 설정하고 다른 값을 0으로 설정하거나 두 값을 모두 0으로 설정합니다.
  • PermissionToRelease: 이 권한 및 PermissionToRequestRelease를 값 1로 설정하지 마세요. 한 값을 1로 설정하고 다른 값을 0으로 설정하거나 두 값을 모두 0으로 설정합니다. 이 권한은 맬웨어 또는 높은 신뢰도 피싱으로 격리된 메시지에 적용되지 않습니다. 격리 정책에서 사용자에게 이 권한을 부여하면 사용자는 권한ToRequestRelease를 선택한 것처럼 격리된 맬웨어 또는 높은 신뢰도 피싱 메시지의 릴리스를 요청할 수 있습니다.
  • PermissionToPreview
  • PermissionToDelete

미리 설정된 최종 사용자 권한 그룹의 값은 다음 목록에 설명되어 있습니다.

  • 액세스 권한 없음: Binary = 0000000이므로 10진수 값 0을 사용합니다.
  • 제한된 액세스: Binary = 00011011 10진수 값 27을 사용합니다.
  • 전체 액세스: Binary = 00010111 10진수 값 23을 사용합니다.

사용자 지정 권한의 경우 원하는 권한에 해당하는 이진 값을 가져옵니다. 이진 값을 사용할 10진수 값으로 변환합니다. 이 매개 변수에 이진 값을 사용하지 마세요.

참고: 이 매개 변수의 값이 0(액세스 없음)이고 ESNEnabled 매개 변수 값이 $true 경우 사용자는 격리에서 메시지를 볼 수 있지만 메시지에 사용할 수 있는 유일한 작업은 메시지 헤더 보기입니다.

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

-EndUserSpamNotificationCustomFromAddress

EndUserSpamNotificationCustomFromAddress는 격리 알림의 보낸 사람으로 사용할 기존 내부 보낸 사람의 이메일 주소를 지정합니다. 이 매개 변수를 기본 이메일 주소 quarantine@messaging.microsoft.com로 다시 설정하려면 값 $null 사용합니다.

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

-EndUserSpamNotificationFrequency

EndUserSpamNotificationFrequency 매개 변수는 사용자에게 격리 알림을 보내는 빈도를 종으로 지정합니다. 유효한 값은 다음과 같습니다.

  • 04:00:00(4시간)
  • 1.00:00:00(1일)
  • 7.00:00:00(7일)
Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

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

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

-EndUserSpamNotificationLanguage

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

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EsnCustomSubject

EsnCustomSubject 매개 변수는 격리 알림의 주체 필드에 사용할 텍스트를 지정합니다.

구문을 ('value1',''value2',...'valueN')사용하여 여러 값을 쉼표로 구분하여 지정할 수 있습니다. MultiLanguageSetting 매개 변수를 사용하여 지정하는 각 언어에 대해 고유한 보낸 사람 텍스트를 지정해야 합니다. 해당하는 MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject 및 MultiLanguageSenderName 매개 변수 값을 동일한 순서로 정렬해야 합니다.

기존 값을 수정하고 다른 값을 유지하려면 모든 기존 값과 새 값을 기존 순서로 지정해야 합니다.

이 설정은 전역 격리 정책 설정을 제어하는 DefaultGlobalTag라는 기본 제공 격리 정책에서만 사용할 수 있습니다. 이 격리 정책에 액세스하려면 다음 구문을 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...사용하여 명령을 시작합니다.

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

-ESNEnabled

ESNEnabled 매개 변수는 정책에 대해 격리 알림(이전의 최종 사용자 스팸 알림)을 사용하도록 설정할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 격리 알림이 사용하도록 설정됩니다.
  • $false: 격리 알림이 비활성화됩니다. 사용자는 격리된 메시지에만 액세스할 수 있으며 메일 알림 액세스할 수 없습니다. 이 값은 기본값입니다.

참고: 이 매개 변수의 값이 $true EndUserQuarantinePermissionsValue 매개 변수 값이 0인 경우(모든 권한이 해제된 위치에 대한 액세스 권한 없음) 사용자는 격리에서 메시지를 볼 수 있지만 메시지에 사용할 수 있는 유일한 작업은 메시지 헤더 보기입니다.

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

-Identity

Identity 매개 변수는 수정하려는 격리 정책을 지정합니다. 격리 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • DN(고유 이름)
  • GUID
Type:QuarantineTagIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

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

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

-MultiLanguageCustomDisclaimer

MultiLanguageCustomDisclaimer 매개 변수는 격리 알림 아래쪽에서 사용할 사용자 지정 고지 사항 텍스트를 지정합니다. 지역화된 텍스트인 organization 고지 사항: 항상 먼저 포함되며, 그 뒤에는 이 매개 변수에 대해 지정한 텍스트가 포함됩니다.

구문을 ('value1',''value2',...'valueN')사용하여 여러 값을 쉼표로 구분하여 지정할 수 있습니다. MultiLanguageSetting 매개 변수를 사용하여 지정하는 각 언어에 대해 고유한 사용자 지정 고지 사항 텍스트를 지정해야 합니다. 해당하는 MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject 및 MultiLanguageSenderName 매개 변수 값을 동일한 순서로 정렬해야 합니다.

기존 값을 수정하고 다른 값을 유지하려면 모든 기존 값과 새 값을 기존 순서로 지정해야 합니다.

이 설정은 전역 격리 정책 설정을 제어하는 DefaultGlobalTag라는 기본 제공 격리 정책에서만 사용할 수 있습니다. 이 격리 정책에 액세스하려면 다음 구문을 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...사용하여 명령을 시작합니다.

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

-MultiLanguageSenderName

MultiLanguageSenderName 매개 변수는 격리 알림에 사용할 전자 메일 보낸 사람의 표시 이름을 지정합니다.

구문을 ('value1',''value2',...'valueN')사용하여 여러 값을 쉼표로 구분하여 지정할 수 있습니다. MultiLanguageSetting 매개 변수를 사용하여 지정하는 각 언어에 대해 고유한 보낸 사람 이름을 지정할 수 있습니다. 해당하는 MultiLanguageSetting, MultiLanguageCustomDisclaimer 및 MultiLanguageSenderName 매개 변수 값을 동일한 순서로 정렬해야 합니다.

기존 값을 수정하고 다른 값을 유지하려면 모든 기존 값과 새 값을 기존 순서로 지정해야 합니다.

이 설정은 전역 설정을 제어하는 DefaultGlobalTag라는 기본 제공 격리 정책에서만 사용할 수 있습니다. 이 격리 정책에 액세스하려면 다음 구문을 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...사용하여 명령을 시작합니다.

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

-MultiLanguageSetting

MultiLanguageSetting 매개 변수는 격리 알림의 언어를 지정합니다. 유효한 값은 다음과 같습니다.

기본값, 암하라어, 아랍어, 바스크어, 벵골어, 불가리아어, 카탈로니아어, 중국어, 중국어 간체, 크로아티아어, 키릴 자모, 체코어, 덴마크어, 네덜란드어, 영어, 에스토니아어, 필리핀어, 핀란드어, 프랑스어, 갈리시아어, 독일어, 그리스어, 구자라트어, 히브리어, 힌디어, 헝가리어, 아이슬란드어, 인도네시아어, 이탈리아어, 일본어, 칸나다, 카자흐어, 한국어, 라트비아어, 리투아니아어, 말레이어, 말라얄람, 마라티어, 노르웨이어, 노르웨이어Nynorsk, Odia, 페르시아어, 폴란드어, 포르투갈어, 포르투갈어, 포르투갈어Portugal, 루마니아어, 러시아어, 세르비아어, 세르비아어 키릴 자모 슬로바키아어, 슬로베니아어, 스페인어, 스와힐리어, 스웨덴어, 타밀어, 텔루구어, 태국어, 터키어, 우크라이나어, 우르두어 및 베트남어.

구문을 ('value1',''value2',...'valueN')사용하여 쉼표로 구분된 여러 값을 지정할 수 있습니다. 기본값은 기본값입니다. 즉, 격리 알림은 클라우드 기반 organization 기본 언어를 사용합니다.

지정하는 각 언어에 대해 MultiLanguageCustomDisclaimer 및 MultiLanguageSenderName 매개 변수에 대한 고유 값을 지정할 수 있습니다. 해당하는 MultiLanguageSetting, MultiLanguageCustomDisclaimer 및 MultiLanguageSenderName 매개 변수 값을 동일한 순서로 정렬해야 합니다.

이 설정은 전역 설정을 제어하는 DefaultGlobalTag라는 기본 제공 격리 정책에서만 사용할 수 있습니다. 이 격리 정책에 액세스하려면 다음 구문을 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...사용하여 명령을 시작합니다.

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

-OrganizationBrandingEnabled

OrganizationBrandingEnabled 매개 변수는 최종 사용자 격리 알림 메시지에서 organization 브랜딩을 사용하거나 사용하지 않도록 설정합니다. 유효한 값은 다음과 같습니다.

  • $true: 조직 브랜딩을 사용할 수 있습니다. 격리 알림에 사용되는 기본 Microsoft 로고는 사용자 지정 로고로 바뀝니다. 이렇게 하려면 사용자 지정 로고를 업로드하려면 organization Microsoft 365 테마 사용자 지정의 지침을 따라야 합니다.
  • $false: 조직 브랜딩을 사용할 수 없습니다. 기본 Microsoft 로고는 격리 알림에 사용됩니다. 이 값은 기본값입니다.

이 설정은 전역 설정을 제어하는 DefaultGlobalTag라는 기본 제공 격리 정책에서만 사용할 수 있습니다. 이 격리 정책에 액세스하려면 다음 구문을 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...사용하여 명령을 시작합니다.

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

-QuarantineRetentionDays

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

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

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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