New-QuarantinePolicy
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
New-QuarantinePolicy コマンドレットを使用して、クラウドベースのorganizationで検疫ポリシーを作成します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
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>]
説明
検疫ポリシーは、メッセージが検疫された理由 (サポートされている機能の場合) と検疫通知の設定に基づいて、検疫されたメッセージに対してユーザーが実行できる操作を定義します。 詳細については、「検疫ポリシー」を参照してください。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0
この例では、No access preset アクセス許可グループと同じアクセス許可を持つ ContosoTag という名前の新しい検疫ポリシーを作成します。
制限付きアクセスのアクセス許可を割り当てるには、値 27 を使用します。 フル アクセスのアクセス許可を割り当てるには、値 23 を使用します。
パラメーター
-AdminDisplayName
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
AdminDisplayName パラメーターは、検疫ポリシーの説明を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminNotificationFrequencyInDays
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminNotificationLanguage
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | EsnLanguage |
| 規定値: | None |
| 指定可能な値: | 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 |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminNotificationsEnabled
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminQuarantinePermissionsList
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CustomDisclaimer
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserQuarantinePermissions
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
注: 検疫ポリシーでアクセス許可を設定するには、EndUserQuarantinePermissionsValue パラメーターを使用することをお勧めします。
EndUserQuarantinePermissions は、New-QuarantinePermissions または Set-QuarantinePermissions コマンドの出力からの変数を使用して、検疫ポリシーのエンド ユーザー アクセス許可を指定します。
たとえば、次のコマンドを実行して、必要なアクセス許可を変数 $Perms = New-QuarantinePermissions <permissions> に格納します。 同じ PowerShell セッションで、このパラメーターの値 $Perms を使用します。
パラメーターのプロパティ
| 型: | QuarantinePermissions |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserQuarantinePermissionsValue
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
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 に設定します。 このアクセス許可は、マルウェアまたは高信頼度フィッシングとして検疫されたメッセージには適用されません。 検疫ポリシーによってこのアクセス許可が与えられた場合、PermissionToRequestRelease が選択されたかのように、ユーザーは検疫されたマルウェアまたは信頼度の高いフィッシング メッセージのリリースを要求できます。
- PermissionToPreview
- PermissionToDelete
事前設定されたエンド ユーザー権限グループの値を次の一覧に示します。
- アクセスなし: Binary = 0000000。そのため、10 進値 0 を使用します。
- 制限付きアクセス: Binary = 00101011。そのため、10 進値 43 を使用します。
- フル アクセス: Binary = 00100111 なので、10 進値 39 を使用します。
カスタム アクセス許可の場合は、必要なアクセス許可に対応するバイナリ値を取得します。 バイナリ値を使用する 10 進数値に変換します。 このパラメーターにバイナリ値を使用しないでください。
注: このパラメーターの値が 0 (アクセスなし) で、ESNEnabled パラメーターの値が $true の場合、ユーザーは隔離された状態でメッセージを表示できますが、メッセージに対して使用できるアクションは [ メッセージ ヘッダーの表示] のみです。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserSpamNotificationCustomFromAddress
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
EndUserSpamNotificationCustomFromAddress は、検疫通知の送信者として使用する既存の内部送信者のメール アドレスを指定します。
このパラメーターを使用しない場合、既定の送信者は quarantine@messaging.microsoft.com になります。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserSpamNotificationFrequency
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
EndUserSpamNotificationFrequency パラメーターは、検疫通知がユーザーに送信される頻度を指定します。 有効な値は次のとおりです。
- 04:00:00 (4 時間)
- 1.00:00:00 (1 日)
- 7.00:00:00 (7 日)
パラメーターのプロパティ
| 型: | TimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserSpamNotificationFrequencyInDays
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserSpamNotificationLanguage
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | EsnLanguage |
| 規定値: | None |
| 指定可能な値: | 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 |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EsnCustomSubject
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
EsnCustomSubject パラメーターは、検疫通知の [サブジェクト] フィールドで使用するテキストを指定します。
構文 ('value1',''value2',...'valueN') を使用して、コンマで区切って複数の値を指定できます。 MultiLanguageSetting パラメーターで指定する言語ごとに、一意の送信者テキストを指定する必要があります。 対応する MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject、MultiLanguageSenderName パラメーターの値を同じ順序で揃えてください。
既存の値を変更し、その他の値を維持するには、既存のすべての値と、既存の順序の新しい値を指定する必要があります。
この設定は、グローバル検疫ポリシーの設定を制御する DefaultGlobalTag という名前の組み込み検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文を使用してコマンドを開始します。 Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | MultiValuedProperty |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ESNEnabled
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ESNEnabled パラメーターは、ポリシーの検疫通知 (旧称: エンド ユーザー スパム通知) を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 検疫通知が有効になっています。
- $false: 検疫通知は無効になっています。 ユーザーは、メール通知ではなく、検疫されたメッセージにのみアクセスできます。 この値が既定値です。
注: このパラメーターの値が $true で、EndUserQuarantinePermissionsValue パラメーターの値が 0 (すべてのアクセス許可がオフになっているアクセスなし) の場合、ユーザーは隔離された状態でメッセージを表示できますが、メッセージに対して使用できるアクションは [ メッセージ ヘッダーの表示] のみです。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeMessagesFromBlockedSenderAddress
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
IncludeMessagesFromBlockedSenderAddress パラメーターは、ブロックされた送信者アドレスから検疫されたメッセージの検疫通知を送信するかどうかを指定します。 有効な値は次のとおりです。
- $true: 受信者は、ブロックされた送信者から影響を受けるメッセージに関する検疫通知を受け取ります。
- $false: 受信者は、ブロックされた送信者から影響を受けるメッセージに関する検疫通知を受け取りません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MultiLanguageCustomDisclaimer
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MultiLanguageSenderName
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MultiLanguageSetting
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Name パラメーターは、検疫ポリシーの一意の名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OrganizationBrandingEnabled
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QuarantinePolicyType
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | QuarantinePolicyType |
| 規定値: | None |
| 指定可能な値: | QuarantinePolicy, GlobalQuarantinePolicy |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QuarantineRetentionDays
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。