共用方式為


Set-TenantAllowBlockListItems

此指令程式只能在雲端式服務中使用。

使用 Set-TenantAllowBlockListItems Cmdlet 來修改 Microsoft 365 Defender 入口網站中 [租使用者允許/封鎖清單] 中的專案。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

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>]

Description

在大部分情況下,您無法修改現有專案的 URL、檔案或寄件者值。 唯一的例外是允許網路釣魚模擬的 URL 專案 (Action = Allow、ListType = URL,以及 ListSubType = AdvancedDelivery) 。 如需允許 URL 進行網路釣魚模擬的詳細資訊,請參閱設定將 協力廠商網路釣魚模擬傳遞給使用者,並將未篩選的郵件傳遞至 SecOps 信箱

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 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 Cmdlet 輸出中專案的 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 Cmdlet 輸出的 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
  • 寄件者
  • 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 參數會指定是否要傳回單一 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