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 參數會進一步指定您想要修改的專案。 有效值為：
- 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
- 寄件者
- 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 |