New-QuarantinePolicy
이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.
New-QuarantinePolicy cmdlet을 사용하여 클라우드 기반 organization 격리 정책을 만듭니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
New-QuarantinePolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantinePolicyType <QuarantinePolicyType>]
[-QuarantineRetentionDays <Int32>]
[<CommonParameters>] Description
격리 정책은 메시지가 격리된 이유(지원되는 기능의 경우) 및 격리 알림 설정에 따라 사용자가 격리된 메시지에 대해 수행할 수 있는 작업을 정의합니다. 자세한 내용은 격리 정책을 참조하세요.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0이 예제에서는 액세스 사전 설정 권한 그룹과 동일한 권한을 가진 ContosoTag라는 새 격리 정책을 만듭니다.
제한된 액세스 권한을 할당하려면 값 27을 사용합니다. 전체 액세스 권한을 할당하려면 값 23을 사용합니다.
매개 변수
-AdminDisplayName
적용 가능: Exchange Online, Exchange Online Protection
AdminDisplayName 매개 변수는 격리 정책에 대한 설명을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AdminNotificationFrequencyInDays
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AdminNotificationLanguage
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | EsnLanguage |
| 허용되는 값: | 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 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AdminNotificationsEnabled
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AdminQuarantinePermissionsList
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CustomDisclaimer
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DomainController
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | Fqdn |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndUserQuarantinePermissions
적용 가능: Exchange Online, Exchange Online Protection
참고: 격리 정책에서 사용 권한을 설정하려면 EndUserQuarantinePermissionsValue 매개 변수를 사용하는 것이 좋습니다.
EndUserQuarantinePermissions는 New-QuarantinePermissions 또는 Set-QuarantinePermissions 명령의 출력에서 변수를 사용하여 격리 정책에 대한 최종 사용자 권한을 지정합니다.
예를 들어 다음 명령을 실행하여 필요한 권한을 변수 $Perms = New-QuarantinePermissions <permissions>에 저장합니다. 동일한 PowerShell 세션에서 이 매개 변수의 값을 $Perms 사용합니다.
| 형식: | QuarantinePermissions |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndUserQuarantinePermissionsValue
적용 가능: Exchange Online, Exchange Online Protection
EndUserQuarantinePermissionsValue 매개 변수는 격리 정책에 대한 최종 사용자 권한을 지정합니다.
이 매개 변수는 이진 값에서 변환된 10진수 값을 사용합니다. 이진 값은 특정 순서로 사용 가능한 권한 목록에 해당합니다. 각 권한에 대해 값 1은 True이고 값 0은 False와 같습니다. 필수 순서는 다음 목록에서 가장 높음(1000000 또는 128)에서 가장 낮은 순서(00000001 또는 1)로 설명합니다.
- PermissionToViewHeader: 값 0은 격리에서 메시지 헤더 보기 작업을 숨기지 않습니다. 메시지가 격리에 표시되는 경우 메시지에 대해 항상 작업을 사용할 수 있습니다.
- PermissionToDownload: 이 권한은 사용되지 않습니다(값 0 또는 1은 아무 작업도 수행하지 않음).
- PermissionToAllowSender
- PermissionToBlockSender
- PermissionToRequestRelease: 이 권한 및 PermissionToRelease를 값 1로 설정하지 마세요. 한 값을 1로 설정하고 다른 값을 0으로 설정하거나 두 값을 모두 0으로 설정합니다.
- PermissionToRelease: 이 권한 및 PermissionToRequestRelease를 값 1로 설정하지 마세요. 한 값을 1로 설정하고 다른 값을 0으로 설정하거나 두 값을 모두 0으로 설정합니다. 이 권한은 맬웨어 또는 높은 신뢰도 피싱으로 격리된 메시지에 적용되지 않습니다. 격리 정책이 사용자에게 이 권한을 부여하는 경우 사용자는 권한ToRequestRelease를 선택한 것처럼 격리된 맬웨어 또는 높은 신뢰도 피싱 메시지의 릴리스를 요청할 수 있습니다.
- PermissionToPreview
- PermissionToDelete
미리 설정된 최종 사용자 권한 그룹의 값은 다음 목록에 설명되어 있습니다.
- 액세스 권한 없음: Binary = 0000000이므로 10진수 값 0을 사용합니다.
- 제한된 액세스: Binary = 00101011 10진수 값 43을 사용합니다.
- 전체 액세스: Binary = 00100111 10진수 값 39를 사용합니다.
사용자 지정 권한의 경우 원하는 권한에 해당하는 이진 값을 가져옵니다. 이진 값을 사용할 10진수 값으로 변환합니다. 이 매개 변수에 이진 값을 사용하지 마세요.
참고: 이 매개 변수의 값이 0(액세스 없음)이고 ESNEnabled 매개 변수 값이 $true 경우 사용자는 격리에서 메시지를 볼 수 있지만 메시지에 사용할 수 있는 유일한 작업은 메시지 헤더 보기입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndUserSpamNotificationCustomFromAddress
적용 가능: Exchange Online, Exchange Online Protection
EndUserSpamNotificationCustomFromAddress는 격리 알림의 보낸 사람으로 사용할 기존 내부 보낸 사람의 이메일 주소를 지정합니다.
이 매개 변수를 사용하지 않으면 기본 발신자는 입니다 quarantine@messaging.microsoft.com.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndUserSpamNotificationFrequency
적용 가능: Exchange Online, Exchange Online Protection
EndUserSpamNotificationFrequency 매개 변수는 사용자에게 격리 알림을 보내는 빈도를 지정합니다. 유효한 값은 다음과 같습니다.
- 04:00:00(4시간)
- 1.00:00:00(1일)
- 7.00:00:00(7일)
| 형식: | TimeSpan |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndUserSpamNotificationFrequencyInDays
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndUserSpamNotificationLanguage
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | EsnLanguage |
| 허용되는 값: | 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 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EsnCustomSubject
적용 가능: Exchange Online, Exchange Online Protection
EsnCustomSubject 매개 변수는 격리 알림의 주체 필드에 사용할 텍스트를 지정합니다.
구문을 ('value1',''value2',...'valueN')사용하여 여러 값을 쉼표로 구분하여 지정할 수 있습니다. MultiLanguageSetting 매개 변수를 사용하여 지정하는 각 언어에 대해 고유한 보낸 사람 텍스트를 지정해야 합니다. 해당하는 MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject 및 MultiLanguageSenderName 매개 변수 값을 동일한 순서로 정렬해야 합니다.
기존 값을 수정하고 다른 값을 유지하려면 모든 기존 값과 새 값을 기존 순서로 지정해야 합니다.
이 설정은 전역 격리 정책 설정을 제어하는 DefaultGlobalTag라는 기본 제공 격리 정책에서만 사용할 수 있습니다. 이 격리 정책에 액세스하려면 다음 구문을 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...사용하여 명령을 시작합니다.
| 형식: | MultiValuedProperty |
| 별칭: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ESNEnabled
적용 가능: Exchange Online, Exchange Online Protection
ESNEnabled 매개 변수는 정책에 대해 격리 알림(이전의 최종 사용자 스팸 알림)을 사용하도록 설정할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 격리 알림이 사용하도록 설정됩니다.
- $false: 격리 알림이 비활성화됩니다. 사용자는 격리된 메시지에만 액세스할 수 있으며 메일 알림 액세스할 수 없습니다. 이 값은 기본값입니다.
참고: 이 매개 변수의 값이 $true EndUserQuarantinePermissionsValue 매개 변수 값이 0인 경우(모든 권한이 해제된 위치에 대한 액세스 권한 없음) 사용자는 격리에서 메시지를 볼 수 있지만 메시지에 사용할 수 있는 유일한 작업은 메시지 헤더 보기입니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IncludeMessagesFromBlockedSenderAddress
적용 가능: Exchange Online, Exchange Online Protection
IncludeMessagesFromBlockedSenderAddress 매개 변수는 차단된 보낸 사람 주소에서 격리된 메시지에 대한 격리 알림을 보낼지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 받는 사람은 차단된 보낸 사람으로부터 영향을 받는 메시지에 대한 격리 알림을 받습니다.
- $false: 수신자는 차단된 보낸 사람의 영향을 받는 메시지에 대한 격리 알림을 받지 않습니다. 이 값은 기본값입니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MultiLanguageCustomDisclaimer
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MultiLanguageSenderName
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MultiLanguageSetting
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
적용 가능: Exchange Online, Exchange Online Protection
Name 매개 변수는 격리 정책의 고유한 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OrganizationBrandingEnabled
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-QuarantinePolicyType
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | QuarantinePolicyType |
| 허용되는 값: | QuarantinePolicy, GlobalQuarantinePolicy |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-QuarantineRetentionDays
적용 가능: Exchange Online, Exchange Online Protection
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |