Set-TenantAllowBlockListItems

リファレンス

モジュール:: ExchangePowerShell

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

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

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

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

構文

Set-TenantAllowBlockListItems
   -Ids <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [<CommonParameters>]

Set-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [<CommonParameters>]

説明

ほとんどの場合、既存のエントリの URL、ファイル、または送信者の値を変更することはできません。唯一の例外は、フィッシングシミュレーションの URL エントリを許可することです (Action = Allow、ListType = URL、ListSubType = AdvancedDelivery)。フィッシングシミュレーションの URL を許可する方法の詳細については、「サードパーティ製のフィッシングシミュレーションをユーザーに配信する方法と、フィルター処理されていないメッセージを SecOps メールボックスに配信する」を参照してください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()

次の使用例は、指定したエントリの有効期限を変更します。

例 2

Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021

次の使用例は、指定したサードパーティ製フィッシングシミュレーション URL の URL 許可エントリの有効期限を変更します。

パラメーター

-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

-Entries

Entries パラメーターは、ListType パラメーター値に基づいて変更するエントリを指定します。有効な値は次のとおりです。

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

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

値の種類 (ファイル、送信者、または URL) を混在させたり、同じコマンドでアクションを許可したりブロックしたりすることはできません。

Ids パラメーターでは、このパラメーターを使用できません。

Type:	String[]
Position:	Named
Default value:	None
Required:	True
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」を参照してください。

NoExpiration スイッチでは、このパラメーターを使用できません。

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

-Ids

Ids パラメーターは、変更するエントリを指定します。この値は、Get-TenantAllowBlockListItems コマンドレットの出力の Identity プロパティに表示されます。

このパラメーターの値の例はです RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0。

このパラメーターを Entries パラメーターと共に使用することはできません。

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

-ListSubType

ListSubType パラメーターは、変更するエントリをさらに指定します。有効な値は次のとおりです。

AdvancedDelivery: フィッシングシミュレーション URL にこの値を使用します。詳細については、「サードパーティのフィッシングシミュレーションをユーザーに配信し、フィルター処理されていないメッセージを SecOps メールボックスに配信するように構成する」を参照してください。
テナント: これが既定値です。

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

エントリ自体を識別するには、このパラメーターと共に Entries または Ids パラメーターを使用します。

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 スイッチは、エントリの有効期限が切れないことを指定します。このスイッチで値を指定する必要はありません。

このスイッチは、ListSubType パラメーター値が AdvancedDelivery であるブロックエントリまたは URL 許可エントリで使用できます。

ExpirationDate パラメーターでは、このスイッチを使用できません。

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

-Notes

Notes パラメーターには、オブジェクトに関する追加情報を指定します。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

-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

次の方法で共有