Get-TenantAllowBlockListItems
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
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 |