Get-TenantAllowBlockListItems

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online, Security & Compliance, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Get-TenantAllowBlockListItems コマンドレットを使用して、Microsoft 365 Defender ポータルのテナント許可/ブロック一覧のエントリを表示します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-TenantAllowBlockListItems
   -ListType <ListType>
   [-ExpirationDate <DateTime>]
   [-Allow]
   [-Block]
   [-Entry <String>]
   [-ListSubType <ListSubType[]>]
   [-OutputJson]
   [<CommonParameters>]

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

この例では、許可されているすべてのサードパーティ製フィッシングシミュレーション URL の情報を返します。詳細については、「サードパーティのフィッシングシミュレーションをユーザーに配信し、フィルター処理されていないメッセージを SecOps メールボックスに配信するように構成する」を参照してください。

パラメーター

-Allow

許可スイッチは、許可エントリの結果をフィルター処理します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Block

[ブロック] スイッチは、ブロックエントリの結果をフィルター処理します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Entry

Entry パラメーターは、ListType パラメーター値に基づいて結果をフィルター処理します。有効な値は次のとおりです。

FileHash: 正確な SHA256 ファイルハッシュ値。
送信者: 正確なドメインまたはメールアドレスの値。
Url: 正確な URL 値。

この値は、Get-TenantAllowBlockListItems コマンドレットの出力のエントリの Value プロパティに表示されます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ExpirationDate

ExpirationDate パラメーターは、協定世界時 (UTC) の有効期限で結果をフィルター処理します。

このパラメーターの日付/時刻値を指定するには、次のいずれかのオプションを使用します。

UTC で日付/時刻の値を指定します(例: "2021-05-06 14:30:00z")。
ローカルタイムゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します(例: (Get-Date "5/6/2020 9:30 AM").ToUniversalTime())。詳細については、「Get-Date」を参照してください。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ListSubType

ListSubType パラメーターは、サブタイプによって結果をフィルター処理します。有効な値は次のとおりです。

AdvancedDelivery
テナント: これが既定値です。

Type:	ListSubType[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ListType

ListType パラメーターは、表示するリストを指定します。有効な値は次のとおりです。

FileHash
Sender
Url

Type:	ListType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-NoExpiration

NoExpiration スイッチは、期限切れにならないように設定されているエントリによって結果をフィルター処理します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-OutputJson

OutputJson スイッチは、1 つの JSON 値内のすべてのエントリを返すかどうかを指定します。このスイッチで値を指定する必要はありません。

このスイッチを使用して、構文エラーが含まれる最初のエントリでコマンドが停止しないようにします。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection