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 パラメーターは、変更するエントリをさらに指定します。 有効な値は次のとおりです。

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