Get-TenantAllowBlockListItems
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-TenantAllowBlockListItems コマンドレットを使用して、Microsoft Defender ポータルのテナントの許可/ブロック リストのエントリを表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Expiration (既定)
Get-TenantAllowBlockListItems
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-Entry <String>]
[-ListSubType <ListSubType[]>]
[-OutputJson]
[<CommonParameters>]
NoExpiration
Get-TenantAllowBlockListItems
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-Entry <String>]
[-ListSubType <ListSubType[]>]
[-OutputJson]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-TenantAllowBlockListItems -ListType Url -Block
この例では、ブロックされているすべての URL が返されます。
例 2
Get-TenantAllowBlockListItems -ListType FileHash -Entry "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
この例では、指定されたファイル ハッシュ値の情報を返します。
例 3
Get-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery
この例では、許可されているすべての Microsoft 以外のフィッシング シミュレーション URL の情報を返します。 詳細については、「 Microsoft 以外のフィッシング シミュレーションと SecOps メールボックスへの電子メール配信用に高度な配信ポリシーを構成する」を参照してください。
パラメーター
-Allow
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
[許可] スイッチは、許可エントリの結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | 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 |
-Entry
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
Entry パラメーターは、ListType パラメーター値に基づいて結果をフィルター処理します。 有効な値は次のとおりです。
- FileHash: 正確な SHA256 ファイル ハッシュ値。
- 送信者: 正確なドメインまたはメール アドレスの値。
- URL: 正確な URL 値。
- IP: IPv6 アドレスのみ。 コロン 16 進数またはゼロ圧縮形式の単一 IPv6 アドレス、または CIDR IPv6 の範囲は 1 から 128 です。
この値は、Get-TenantAllowBlockListItems コマンドレットの出力のエントリの Value プロパティに表示されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | 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」を参照してください。
パラメーターのプロパティ
| 型: | DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Expiration
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ListSubType
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
ListSubType パラメーターは、サブタイプで結果をフィルター処理します。 有効な値は次のとおりです。
- AdvancedDelivery
- テナント: この値は既定値です。
パラメーターのプロパティ
| 型: | 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 |
-NoExpiration
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
NoExpiration スイッチは、有効期限が切れないように設定されたエントリで結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NoExpiration
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutputJson
適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン
OutputJson スイッチは、すべてのエントリを単一の JSON 値で返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用すると、構文エラーを含む最初のエントリでコマンドが停止しないようにすることができます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | 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」を参照してください。