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、セキュリティ & コンプライアンス、Exchange Online Protection
許可スイッチは、許可エントリの結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Block
適用対象: Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection
[ブロック] スイッチは、ブロック エントリの結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Entry
適用対象: Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection
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、セキュリティ & コンプライアンス、Exchange Online Protection
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、セキュリティ & コンプライアンス、Exchange Online Protection
ListSubType パラメーターは、サブタイプによって結果をフィルター処理します。 有効な値は次のとおりです。
- AdvancedDelivery
- テナント: この値が既定値です。
パラメーターのプロパティ
| 型: | ListSubType[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ListType
適用対象: Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection
ListType パラメーターは、表示するリストを指定します。 有効な値は次のとおりです。
- FileHash
- Sender
- Url
- IP
パラメーターのプロパティ
| 型: | ListType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoExpiration
適用対象: Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection
NoExpiration スイッチは、期限切れにならないように設定されているエントリによって結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NoExpiration
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutputJson
適用対象: Exchange Online、セキュリティ & コンプライアンス、Exchange Online Protection
OutputJson スイッチは、1 つの 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」を参照してください。