Set-QuarantinePolicy
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Set-QuarantinePolicy コマンドレットを使用して、クラウドベースのorganizationの検疫ポリシーを変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-QuarantinePolicy
[-Identity] <QuarantineTagIdParameter>
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-Confirm]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IgnoreDehydratedFlag]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantineRetentionDays <Int32>]
[-WhatIf]
[<CommonParameters>]
説明
AdminOnlyAccessPolicy、DefaultFullAccessPolicy、または DefaultFullAccessWithNotificationPolicy という名前の組み込みの検疫ポリシーを変更することはできません。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1
次の使用例は、ユーザーが検疫されたメッセージのみを削除できるようにする CustomAccess という名前の検疫ポリシーのアクセス許可を構成します。
例 2
Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息,请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00
次の使用例は、検疫通知のグローバル設定 (以前はエンド ユーザースパム通知設定) を変更します。
- 検疫通知は、英語、中国語、フランス語用にカスタマイズされています。 フランス語 MultiLanguageCustomDisclaimer 値では、テキスト内の引用符文字のエスケープ文字として余分な引用符が必要です。
- 既存のユーザー aashutosh@contso.onmicrosoft.com は、検疫通知の送信者として使用されます。
- 以前に構成したカスタム ロゴは、既定の Microsoft ロゴに置き換えられます。
- 検疫通知の頻度が 4 時間に変更されます。
パラメーター
-AdminNotificationFrequencyInDays
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-AdminNotificationLanguage
このパラメーターは、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 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-AdminNotificationsEnabled
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-AdminQuarantinePermissionsList
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、この構文 (-Confirm:$false) を正しくを使用すると確認のメッセージを省略できます。
- 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-CustomDisclaimer
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-DomainController
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | Fqdn |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissions
注: 検疫ポリシーでアクセス許可を設定するには、EndUserQuarantinePermissionsValue パラメーターを使用することをお勧めします。
EndUserQuarantinePermissions は、New-QuarantinePermissions または Set-QuarantinePermissions コマンドの出力の変数を使用して、検疫ポリシーのエンド ユーザーアクセス許可を指定します。
たとえば、次のコマンドを実行して、必要なアクセス許可を変数 $Perms = New-QuarantinePermissions <permissions>
に格納します。 同じ PowerShell セッションで、このパラメーターに $Perms
値を使用します。
型: | QuarantinePermissions |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissionsValue
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 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationCustomFromAddress
EndUserSpamNotificationCustomFromAddress は、検疫通知の送信者として使用する既存の内部送信者のメール アドレスを指定します。 このパラメーターを既定のメール アドレス quarantine@messaging.microsoft.comに戻すには、値 $nullを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequency
EndUserSpamNotificationFrequency パラメーターの種類は、検疫通知がユーザーに送信される頻度です。 有効な値は次のとおりです。
- 04:00:00 (4 時間)
- 1.00:00:00 (1 日)
- 7.00:00:00 (7 日)
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequencyInDays
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationLanguage
このパラメーターは、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 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-EsnCustomSubject
EsnCustomSubject パラメーターは、検疫通知の [件名] フィールドで使用するテキストを指定します。
('value1',''value2',...'valueN')
という構文を使用して、複数の値をコンマで区切って指定できます。 MultiLanguageSetting パラメーターで指定する言語ごとに、一意の Sender テキストを指定する必要があります。 対応する MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject、MultiLanguageSenderName パラメーターの値を同じ順序で配置してください。
既存の値を変更して他の値を保持するには、既存のすべての値と新しい値を既存の順序で指定する必要があります。
この設定は、グローバル検疫ポリシー設定を制御する DefaultGlobalTag という名前の組み込みの検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文でコマンドを開始します: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
。
型: | MultiValuedProperty |
Aliases: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-ESNEnabled
ESNEnabled パラメーターは、ポリシーの検疫通知 (旧称エンド ユーザースパム通知) を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 検疫通知が有効になっています。
- $false: 検疫通知は無効になっています。 ユーザーは、メール通知ではなく、検疫中の検疫済みメッセージにのみアクセスできます。 これは既定の値です。
注: このパラメーターの値が$trueで、EndUserQuarantinePermissionsValue パラメーターの値が 0 の場合 (すべてのアクセス許可がオフになっている場合はアクセスできません)、ユーザーは検疫でメッセージを表示できますが、メッセージに対して使用可能なアクションは メッセージ ヘッダーの表示のみです。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Identity
Identity パラメーターは、変更する検疫ポリシーを指定します。 検疫ポリシーを一意に識別する任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
型: | QuarantineTagIdParameter |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-IgnoreDehydratedFlag
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-IncludeMessagesFromBlockedSenderAddress
IncludeMessagesFromBlockedSenderAddress パラメーターは、ブロックされた送信者アドレスから検疫されたメッセージに対して検疫通知を送信するかどうかを指定します。 有効な値は次のとおりです。
- $true: 受信者は、ブロックされた送信者から影響を受けるメッセージの検疫通知を受け取ります。
- $false: 受信者は、ブロックされた送信者から影響を受けるメッセージの検疫通知を受け取りません。 これは既定の値です。
型: | Boolean |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-MultiLanguageCustomDisclaimer
MultiLanguageCustomDisclaimer パラメーターは、検疫通知の下部付近で使用するカスタム免責事項テキストを指定します。 ローカライズされたテキストである organization の免責事項は常に最初に含まれ、その後にこのパラメーターに指定したテキストが続きます。
('value1',''value2',...'valueN')
という構文を使用して、複数の値をコンマで区切って指定できます。 MultiLanguageSetting パラメーターで指定する言語ごとに、一意のカスタム免責事項テキストを指定する必要があります。 対応する MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject、MultiLanguageSenderName パラメーターの値を同じ順序で配置してください。
既存の値を変更して他の値を保持するには、既存のすべての値と新しい値を既存の順序で指定する必要があります。
この設定は、グローバル検疫ポリシー設定を制御する DefaultGlobalTag という名前の組み込みの検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文でコマンドを開始します: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-MultiLanguageSenderName
MultiLanguageSenderName パラメーターは、検疫通知で使用する電子メール送信者の表示名を指定します。
('value1',''value2',...'valueN')
という構文を使用して、複数の値をコンマで区切って指定できます。 MultiLanguageSetting パラメーターで指定する言語ごとに、一意の送信者名を指定できます。 対応する MultiLanguageSetting、MultiLanguageCustomDisclaimer、MultiLanguageSenderName パラメーターの値を同じ順序で配置してください。
既存の値を変更して他の値を保持するには、既存のすべての値と新しい値を既存の順序で指定する必要があります。
この設定は、グローバル設定を制御する DefaultGlobalTag という名前の組み込みの検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文でコマンドを開始します: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-MultiLanguageSetting
MultiLanguageSetting パラメーターは、検疫通知の言語を指定します。 有効な値は次のとおりです。
既定値、Amharic、アラビア語、バスク語、ベンガル語India、ブルガリア語、カタロニア語、簡体字中国語、ChineseTraditional、クロアチア語、キリル文字、チェコ語、 デンマーク語、オランダ語、英語、エストニア語、フィリピン語、フィンランド語、フランス語、ガリシア語、ドイツ語、ギリシャ語、グジャラート語、ヘブライ語、ヒンディー語、ハンガリー語、アイスランド語、インドネシア語、イタリア語、カンナダ、カザフ語、韓国語、ラトビア語、リトアニア語、マレー語、マラヤラム語、Marathi、ノルウェー語、ノルウェー語、オディア、ペルシャ語、ポーランド語、ポルトガル語、ポルトガル語、ポルトガル語、ルーマニア語、ロシア語、セルビア語、セルビア語、 スロバキア語、スロベニア語、スペイン語、Swahili、スウェーデン語、タミル語、テルグ語、タイ語、トルコ語、ウクライナ語、ウルドゥー語、ベトナム語。
('value1',''value2',...'valueN')
という構文を使用して、複数の値をコンマで区切って指定できます。 既定値は Default です。つまり、検疫通知ではクラウドベースのorganizationの既定の言語が使用されます。
指定する言語ごとに、MultiLanguageCustomDisclaimer パラメーターと MultiLanguageSenderName パラメーターに一意の値を指定できます。 対応する MultiLanguageSetting、MultiLanguageCustomDisclaimer、MultiLanguageSenderName パラメーターの値を同じ順序で配置してください。
この設定は、グローバル設定を制御する DefaultGlobalTag という名前の組み込みの検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文でコマンドを開始します: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
。
注: 値 English は、en-US を除くすべての英語言語コードにマップされます。 en-US メールボックスのみを持つユーザーがいる場合は、[既定値] の値を使用します。 en-US およびその他の英語の言語コード (en-GB、en-CA、en-AU など) とメールボックスが混在している場合は、カスタマイズされた検疫通知の 1 つで [既定値] を使用し、別のカスタマイズされた検疫通知では [英語] の値を使用します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
OrganizationBrandingEnabled パラメーターを使用すると、エンド ユーザー検疫通知メッセージorganizationブランド化が有効または無効になります。 有効な値は次のとおりです。
- $true: 組織のブランド化が有効になっています。 検疫通知で使用される既定の Microsoft ロゴは、カスタム ロゴに置き換えられます。 これを行う前に、「組織の Microsoft 365 テーマをカスタマイズ」の手順に従ってカスタム ロゴをアップロードする必要があります。
- $false: 組織のブランド化が無効になっています。 既定の Microsoft ロゴは検疫通知で使用されます。 これは既定の値です。
この設定は、グローバル設定を制御する DefaultGlobalTag という名前の組み込みの検疫ポリシーでのみ使用できます。 この検疫ポリシーにアクセスするには、次の構文でコマンドを開始します: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-QuarantineRetentionDays
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |