New-QuarantinePolicy

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

New-QuarantinePolicy コマンドレットを使用して、クラウドベースのorganizationに検疫ポリシーを作成します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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>]

説明

検疫ポリシーでは、メッセージが検疫された理由 (サポートされている機能の場合) と検疫通知の設定に基づいて、検疫されたメッセージに対してユーザーが実行できる操作を定義します。 詳細については、「検疫ポリシー」を参照してください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 つの値を 1 に設定し、もう一方の値を 0 に設定するか、両方の値を 0 に設定します。
  • PermissionToRelease: このアクセス許可と PermissionToRequestRelease を値 1 に設定しないでください。 1 つの値を 1 に設定し、もう一方の値を 0 に設定するか、両方の値を 0 に設定します。 このアクセス許可は、マルウェアまたは高信頼フィッシングとして検疫されたメッセージには適用されません。 検疫ポリシーによってユーザーにこのアクセス許可が付与された場合、ユーザーは、検疫されたマルウェアまたは信頼度の高いフィッシング メッセージのリリースを、代わりに PermissionToRequestRelease が選択されているかのように要求できます。
  • 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 パラメーターで指定する言語ごとに、一意の Sender テキストを指定する必要があります。 対応する 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