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
この例では、[アクセスなし] プリセットのアクセス許可グループと同じアクセス許可を持つ ContosoTag という名前の新しい検疫ポリシーを作成します。
制限付きアクセス許可を割り当てるには、値 27 を使用します。 フル アクセス許可を割り当てるには、値 23 を使用します。
パラメーター
-AdminDisplayName
適用対象: Exchange Online、Exchange Online Protection
AdminDisplayName パラメーターは、検疫ポリシーの説明を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminNotificationFrequencyInDays
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminNotificationLanguage
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、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、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AdminQuarantinePermissionsList
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CustomDisclaimer
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserQuarantinePermissions
適用対象: Exchange Online、Exchange Online Protection
注: 検疫ポリシーでアクセス許可を設定するには、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、Exchange Online Protection
EndUserQuarantinePermissionsValue パラメーターは、検疫ポリシーのエンド ユーザーのアクセス許可を指定します。
このパラメーターは、バイナリ値から変換された 10 進値を使用します。 バイナリ値は、特定の順序で使用可能なアクセス許可の一覧に対応します。 各アクセス許可で、値 1 は True、値 0 は False となります。 必要な順序は、最高 (1000000 または 128) から最も低い (00000001または 1) まで、次の一覧で説明されています。
- PermissionToViewHeader: 値 0 は、検疫の [メッセージ ヘッダーの表示 ] アクションを非表示にしません。 メッセージが検疫に表示されている場合、アクションは常にメッセージに対して使用できます。
- PermissionToDownload: このアクセス許可は使用されません (値 0 または 1 は何も行いません)。
- PermissionToAllowSender
- PermissionToBlockSender
- PermissionToRequestRelease: このアクセス許可と PermissionToRelease を値 1 に設定しないでください。 1 つの値を 1 に設定し、もう一方の値を 0 に設定するか、両方の値を 0 に設定します。
- PermissionToRelease: このアクセス許可と PermissionToRequestRelease を値 1 に設定しないでください。 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、Exchange Online Protection
EndUserSpamNotificationCustomFromAddress は、検疫通知の送信者として使用する既存の内部送信者のメール アドレスを指定します。
このパラメーターを使用しない場合、既定の送信者は quarantine@messaging.microsoft.com。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | 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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserSpamNotificationFrequencyInDays
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndUserSpamNotificationLanguage
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、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、Exchange Online Protection
EsnCustomSubject パラメーターは、検疫通知の [件名] フィールドで使用するテキストを指定します。
('value1',''value2',...'valueN')という構文を使用して、複数の値をコンマで区切って指定できます。 MultiLanguageSetting パラメーターで指定する言語ごとに、一意の Sender テキストを指定する必要があります。 対応する MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject、MultiLanguageSenderName パラメーターの値を同じ順序で配置してください。
既存の値を変更して他の値を保持するには、既存のすべての値と新しい値を既存の順序で指定する必要があります。
この設定は、グローバル検疫ポリシー設定を制御する DefaultGlobalTag という名前の組み込みの検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文でコマンドを開始します: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | MultiValuedProperty |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ESNEnabled
適用対象: Exchange Online、Exchange Online Protection
ESNEnabled パラメーターは、ポリシーの検疫通知 (旧称エンド ユーザースパム通知) を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 検疫通知が有効になっています。
- $false: 検疫通知は無効になっています。 ユーザーは、メール通知ではなく、検疫中の検疫済みメッセージにのみアクセスできます。 この値が既定値です。
注: このパラメーターの値が$trueで、EndUserQuarantinePermissionsValue パラメーターの値が 0 の場合 (すべてのアクセス許可がオフになっている場合はアクセスできません)、ユーザーは検疫でメッセージを表示できますが、メッセージに対して使用可能なアクションは メッセージ ヘッダーの表示のみです。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeMessagesFromBlockedSenderAddress
適用対象: Exchange Online、Exchange Online Protection
IncludeMessagesFromBlockedSenderAddress パラメーターは、ブロックされた送信者アドレスから検疫されたメッセージに対して検疫通知を送信するかどうかを指定します。 有効な値は次のとおりです。
- $true: 受信者は、ブロックされた送信者から影響を受けるメッセージの検疫通知を受け取ります。
- $false: 受信者は、ブロックされた送信者から影響を受けるメッセージの検疫通知を受け取りません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MultiLanguageCustomDisclaimer
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MultiLanguageSenderName
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MultiLanguageSetting
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Online、Exchange Online Protection
Name パラメーターは、検疫ポリシーの一意の名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OrganizationBrandingEnabled
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QuarantinePolicyType
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | QuarantinePolicyType |
| 規定値: | None |
| 指定可能な値: | QuarantinePolicy, GlobalQuarantinePolicy |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QuarantineRetentionDays
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、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」を参照してください。