New-QuarantinePolicy
이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.
New-QuarantinePolicy cmdlet을 사용하여 클라우드 기반 organization 격리 정책을 만듭니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
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>]
[-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
AdminDisplayName 매개 변수는 격리 정책에 대한 설명을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 |
-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진수 값으로 변환합니다. 이 매개 변수에 이진 값을 사용하지 마세요.
참고: 이 매개 변수의 값이 $true EndUserQuarantinePermissionsValue 매개 변수 값이 0인 경우(모든 권한이 해제된 위치에 대한 액세스 권한 없음) 사용자는 격리에서 메시지를 볼 수 있지만 메시지에 사용할 수 있는 유일한 작업은 메시지 헤더 보기입니다.
| 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.
| 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 |
-MultiLanguageCustomDisclaimer
이 매개 변수는 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 |
-MultiLanguageSenderName
이 매개 변수는 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 |
-MultiLanguageSetting
이 매개 변수는 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 |
-Name
Name 매개 변수는 격리 정책의 고유한 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
이 매개 변수는 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 |
-QuarantinePolicyType
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| Type: | QuarantinePolicyType |
| Accepted values: | QuarantinePolicy, GlobalQuarantinePolicy |
| 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 |