Set-TenantAllowBlockListItems

模組:

Exchange PowerShell

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

使用 Set-TenantAllowBlockListItems Cmdlet 修改 Microsoft Defender 入口網站中租用戶允許/封鎖清單中的項目。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Ids (預設值)

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

Entries

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

Description

在建立項目之後，大多數情況下無法修改寄件者、URL、檔案或 IP 位址值。 唯一的例外是網路釣魚模擬的 URL 允許項目 (ListType = URL，ListSubType = AdvancedDelivery) 。 如需允許 URL 進行網路釣魚模擬的詳細資訊，請參閱 設定非 Microsoft 網路釣魚模擬和電子郵件傳遞至 SecOps 信箱的進階傳遞原則。

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 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

本範例會變更指定之非 Microsoft 網路釣魚模擬 URL 之 URL 允許項目的到期日。

參數

-Allow

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

[允許] 參數可指定您要修改允許項目。 您不需要使用此參數指定值。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Block

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

[區塊] 參數可指定您要修改區塊項目。 您不需要使用此參數指定值。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Entries

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

項目參數會根據 ListType 參數值指定您想要修改的項目。 有效值為：

• FileHash：確切的 SHA256 檔案雜湊值。
• 寄件者網域和電子郵件地址：確切的網域或電子郵件地址值。
• Url：確切的 URL 值。
• IP：僅限 IPv6 位址。 冒號十六進位或零壓縮格式或 CIDR IPv6 位址的單一 IPv6 位址範圍從 1 到 128。

此值會顯示在 Get-TenantAllowBlockListItems cmdlet 輸出中項目的 Value 屬性中。

您不能在同一命令中混合使用 (寄件者、URL、檔案或 IP 位址) 或允許與封鎖動作的值類型。

您無法將此參數與 Ids 參數搭配使用。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

Entries

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExpirationDate

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

ExpirationDate 參數會依國際標準時間 (UTC) 的到期日來篩選結果。

若要指定這個參數的日期/時間值，請使用下列其中一個選項︰

• 以 UTC 指定日期/時間值：例如， "2021-05-06 14:30:00z"。
• 將日期/時間值指定為將當地時區的日期/時間轉換為 UTC 的公式：例如， (Get-Date "5/6/2020 9:30 AM").ToUniversalTime()。 如需詳細資訊，請參閱 Get-Date。

您無法將此參數與 NoExpiration 或 RemoveAfter 參數搭配使用。

參數屬性

類型:	DateTime
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Ids

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

Ids 參數會指定您要修改的項目。 此值會顯示在 Get-TenantAllowBlockListItems cmdlet 輸出中的 Identity 屬性中。

此參數的範例值為 RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0。

您無法將此參數與 [項目] 參數搭配使用。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

Ids

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ListSubType

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

ListSubType 參數進一步指定您要修改的項目。 有效值為：

• AdvancedDelivery：針對網路釣魚模擬 URL 使用此值。 如需詳細資訊，請參閱 設定非 Microsoft 網路釣魚模擬和電子郵件傳遞至 SecOps 信箱的進階傳遞原則。
• 租用戶：此值為預設值。

參數屬性

類型:	ListSubType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ListType

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

ListType 參數會指定要修改的項目類型。 有效值為：

• FileHash
• 寄件者
• URL
• IP

將 [項目] 或 [識別碼] 參數與此參數搭配使用，以識別項目本身。

參數屬性

類型:	ListType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoExpiration

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

NoExpiration 參數會指定項目永不過期。 您不需要使用此參數指定值。

此參數可用於下列類型的項目：

• 封鎖項目。
• URL 允許 ListSubType 參數值為 AdvancedDelivery 的項目。
• IP 位址允許項目。

您無法將此參數與 ExpirationDate 參數搭配使用。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Notes

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

Notes 參數會指定有關物件的額外資訊。 如果值包含空格，請使用引號 (") 括住值。 如果值包含引號，請在引號前新增反斜線 ( \ ) 。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-OutputJson

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

OutputJson 參數會指定是否要在單一 JSON 值中傳回所有項目。 您不需要使用此參數指定值。

使用此參數可防止命令在包含語法錯誤的第一個項目上停止。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RemoveAfter

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

RemoveAfter 參數會為允許項目啟用 [在上次使用日期後的 45 天移除>] 功能。 當篩選系統在郵件流程或按一下時間期間遇到允許項目中的錯誤實體時，會填入 LastUsedDate 屬性。 在篩選系統判斷實體為乾淨之後，允許項目會保留 45 天。

此參數的唯一有效值是 45。

您無法將此參數與 ExpirationDate 或 NoExpirationDate 參數搭配使用。

若要將允許項目變更為不依賴於 LastUsedDate 屬性的靜態到期日期/時間值，請執行具有 ExpirationDate 參數的 Set-TenantAllowBlockListItems 命令。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。