New-TenantAllowBlockListItems
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
New-TenantAllowBlockListItems コマンドレットを使用して、Microsoft Defender ポータルのテナント許可/ブロック リストにエントリを追加します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Expiration
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-RemoveAfter <Int32>]
[-SubmissionID <String>]
[<CommonParameters>]
NoExpiration
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-RemoveAfter <Int32>]
[-SubmissionID <String>]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~
この例では、contoso.com とすべてのサブドメイン (たとえば、contoso.com、 www.contoso.com、xyz.abc.contoso.com、 www.contoso.com/b) の URL ブロック エントリを追加します。 ExpirationDate または NoExpiration パラメーターを使用しなかったため、エントリは 30 日後に期限切れになります。
例 2
New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration
この例では、有効期限のない指定されたファイルのファイル ブロック エントリを追加します。
例 3
New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpiration
この例では、指定された Microsoft 以外のフィッシング シミュレーション URL に対して、有効期限のない URL 許可エントリを追加します。 詳細については、「 Microsoft 以外のフィッシング シミュレーションと SecOps メールボックスへの電子メール配信用に高度な配信ポリシーを構成する」を参照してください。
例 4
New-TenantAllowBlockListItems -Allow -ListType Url -Entries abcd.fabrikam.com -RemoveAfter 45
この例では、最後に使用した日から 45 日後に有効期限が指定されたドメインの URL 許可エントリを追加します。 この許可エントリにより、バルク、スパム、高信頼度スパム、フィッシング (高信頼度フィッシングではない) として識別される URL が許可されます。
マルウェアまたは信頼度の高いフィッシングとして識別された URL の場合は、Microsoft が許可エントリを作成するために URL を送信する必要があります。 手順については、「 適切な URL を Microsoft に報告する」を参照してください。
パラメーター
-Allow
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
[許可] スイッチは、許可エントリを作成することを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを [ブロック] スイッチと一緒に使用することはできません。
注: 許可エントリを作成する前に、「 テナントの許可/ブロック リストでエントリを許可する」を参照してください。
Microsoft 以外のフィッシング シミュレーション URL に対して有効期限のない許可エントリを使用することもできます。 詳細については、「 Microsoft 以外のフィッシング シミュレーションと SecOps メールボックスへの電子メール配信用に高度な配信ポリシーを構成する」を参照してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Block
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
[許可] スイッチは、ブロック エントリを作成することを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを [許可] スイッチと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Entries
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Entries パラメーターは、ListType パラメーターの値に基づいて、テナントの許可/ブロック リストに追加する値を指定します。
FileHash: ファイルの SHA256 ハッシュ値を使用します。 SHA256 ハッシュ値は、PowerShell で次のコマンドを実行することで確認できます:
Get-FileHash -Path "<Path>\<Filename>" -Algorithm SHA256。 値の例は768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3です。送信者: ドメインまたはメール アドレスの値。 たとえば、
contoso.comおよびmichelle@contoso.comが禁止となります。URL: IPv4 または IPv6 アドレスまたはホスト名を使用します。 ホスト名ではワイルドカード (* と ~) がサポートされています。 プロトコル、TCP/UDP ポート、またはユーザー資格情報はサポートされません。 詳細については、「 テナントの許可/ブロック リストの URL 構文」を参照してください。
IP: IPv6 アドレスのみ:
• コロン 16 進数形式の単一 IPv6 アドレス(例: 2001:0db8:85a3:0000:0000:8a2e:0370:7334)。
• ゼロ圧縮形式の単一の IPv6 アドレス(たとえば、2001:0db8:0000:0000:0000:0000:0000:0000:0000:0001 の 2001:db8::1)。
・ CIDR IPv6 の範囲は 1 から 128 です(たとえば、2001:0db8::/32)。
複数の値を入力するには、次の構文を使用します: "Value1","Value2",..."ValueN"。
リストのサブタイプ (送信者、URL、ファイル、または IP アドレス) ごとの入力制限:
- Microsoft Defender for Office 365をお持ちでない組織: 許可エントリの最大数は 500、ブロック エントリの最大数は 500 です。
- Defender for Office 365 プラン 1 を使用する組織: 許可エントリの最大数は 1000、ブロック エントリの最大数は 1000 です。
- Defender for Office 365 プラン 2 を使用する組織: 許可エントリの最大数は 5000、ブロック エントリの最大数は 10000 です。
ファイル エントリの最大文字数は 64 文字で、URL エントリの最大文字数は 250 文字です。
値の種類 (送信者、URL、ファイル、または IP アドレス) を混在させたり、同じコマンドでアクションを許可したりブロックしたりすることはできません。
ほとんどの場合、送信者、URL、ファイル、または IP アドレスの各値を、エントリの作成後から変更することはできません。 唯一の例外は、フィッシング シミュレーションの URL 許可エントリです (ListType = URL、ListSubType = AdvancedDelivery)。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExpirationDate
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ExpirationDate パラメーターは、エントリの有効期限を協定世界時 (UTC) で設定します。
このパラメーターの日付/時刻値を指定するには、次のいずれかのオプションを使用します。
- UTC で日付/時刻の値を指定します。たとえば、
"2021-05-06 14:30:00z"。 - ローカル タイム ゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します。たとえば、
(Get-Date "5/6/2020 9:30 AM").ToUniversalTime()などです。 詳細については、「Get-Date」を参照してください。
このパラメーターを NoExpiration または RemoveAfter パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Expiration
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ListSubType
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ListSubType パラメーターは、このエントリのサブタイプを指定します。 有効な値は次のとおりです。
- AdvancedDelivery: フィッシング シミュレーション URL には、この値を使用します。 詳細については、「 Microsoft 以外のフィッシング シミュレーションと SecOps メールボックスへの電子メール配信用に高度な配信ポリシーを構成する」を参照してください。
- テナント: この値は既定値です。
パラメーターのプロパティ
| 型: | ListSubType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ListType
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ListType パラメーターは、追加するエントリの種類を指定します。 有効な値は次のとおりです。
- FileHash
- Sender
- Url
- IP
パラメーターのプロパティ
| 型: | ListType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LogExtraDetails
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
{{ Log ExtraDetails の説明を塗りつぶす }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoExpiration
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
NoExpiration スイッチは、エントリが無期限切れにならないように指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、次のシナリオで使用できます。
- [ブロック] スイッチを使用します。
- ListType パラメーターの値が URL で、ListSubType パラメーターの値が AdvancedDelivery の許可スイッチを使用します。
- ListType パラメーターの値が IP である許可スイッチを使用します。
このスイッチを ExpirationDate または RemoveAfter パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NoExpiration
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Notes
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Notes パラメーターには、オブジェクトに関する追加情報を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。 値に引用符が含まれている場合は、引用符の前に円記号 (\) を追加します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutputJson
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
OutputJson スイッチは、すべてのエントリを単一の JSON 値で返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用すると、構文エラーを含む最初のエントリでコマンドが停止しないようにすることができます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RemoveAfter
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
RemoveAfter パラメーターは、許可エントリの [最後に使用した日付から 45 日後>削除] 機能を有効にします。 LastUsedDate プロパティは、メール フロー中またはクリック時にフィルター システムによって許可エントリ内の正しくないエンティティが検出されたときに設定されます。 許可エントリは、フィルタリング システムがエンティティがクリーンであると判断した後、45 日間保持されます。
このパラメーターの有効な値は 45 のみです。
ListType パラメーターの値が Sender、FileHash、または Url の場合、このパラメーターを Allow スイッチと共に使用できます。
このパラメーターを ExpirationDate パラメーターまたは NoExpirationDate パラメーターと一緒に使用することはできません。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SubmissionID
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | 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」を参照してください。