Set-TenantAllowBlockListItems
此指令程式只能在雲端式服務中使用。
使用 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、安全性 & 合規性、Exchange Online Protection
[允許] 參數會指定您要修改允許專案。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Block
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
[封鎖] 參數會指定您要修改區塊專案。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Entries
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
Entries 參數會根據 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、安全性 & 合規性、Exchange Online Protection
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、安全性 & 合規性、Exchange Online Protection
Ids 參數會指定您要修改的專案。 此值會顯示在 Get-TenantAllowBlockListItems Cmdlet 輸出的 Identity 屬性中。
這個參數的範例值為 RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0。
您無法搭配 Entries 參數使用此參數。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Ids
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListSubType
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
ListSubType 參數會進一步指定您想要修改的專案。 有效值為：
- AdvancedDelivery：將此值用於網路釣魚模擬 URL。 如需詳細資訊， 請參閱設定非Microsoft網路釣魚模擬和電子郵件傳遞至 SecOps 信箱的進階傳遞原則。
- 租使用者：此值為預設值。
參數屬性
| 類型: | ListSubType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListType
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
ListType 參數會指定您要修改的項目類型。 有效值為：
- FileHash
- 寄件者
- URL
- IP
使用 Entries 或 Ids 參數搭配此參數來識別專案本身。
參數屬性
| 類型: | ListType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoExpiration
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
NoExpiration 參數指定項目不應該過期。 您不需要使用此參數指定值。
這個參數可用於下列類型的專案：
- 封鎖專案。
- URL 允許 ListSubType 參數值為 AdvancedDelivery 的專案。
- IP 位址允許專案。
您無法搭配 ExpirationDate 參數使用此參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Notes
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
Notes 參數會指定有關物件的額外資訊。 如果值包含空格，請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OutputJson
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
OutputJson 參數會指定是否要傳回單一 JSON 值中的所有專案。 您不需要使用此參數指定值。
您可以使用此參數來防止命令在包含語法錯誤的第一個專案上停止。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RemoveAfter
適用：Exchange Online、安全性 & 合規性、Exchange Online Protection
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。