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
大多數情況下，建立條目後你無法修改寄件人、網址、檔案或 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 網路釣魚模擬網址的有效期限。
參數
-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、安全 & 合規、內建本地郵箱安全附加元件
Entry 參數會根據 ListType 參數值指定你想修改的項目。 有效值為：
- FileHash：SHA256 檔案的精確雜湊值。
- 寄件人網域與電子郵件地址：精確的網域或電子郵件地址值。
- 網址：精確的網址值。
- IP：僅限 IPv6 位址。 單一 IPv6 位址以冒號十六進位或零壓縮格式（CIDR IPv6）為 1 至 128。
此值顯示於 Get-TenantAllowBlockListItems 指令本輸出項目的 Value 屬性中。
你不能在同一指令裡混用發送者、網址、檔案或 IP) 位址 (值型別，或允許和封鎖動作。
你不能用這個參數搭配 Ids 參數。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Entries
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExpirationDate
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
到期日參數以協調世界時 (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 指令碼輸出中的 Identity 屬性中顯示。
此參數的範例值為 RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0。
你不能用這個參數搭配 Entry 參數。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Ids
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListSubType
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
ListSubType 參數進一步指定你想修改的條目。 有效值為：
- AdvancedDelivery：使用此值用於釣魚模擬網址。 欲了解更多資訊，請參閱 「為非 Microsoft 網路釣魚模擬設定進階投遞政策及 SecOps 郵箱郵件投遞」。
- 租戶：此值為預設值。
參數屬性
| 類型: | ListSubType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListType
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
ListType 參數指定你想修改的條目類型。 有效值為：
- 檔案雜湊
- 寄件者
- URL
- IP
使用帶有此參數的 Enentry 或 Ids 參數來識別該條目本身。
參數屬性
| 類型: | ListType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoExpiration
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
「無過期」開關規定該條目永遠不會過期。 您不需要使用此參數指定值。
此交換器可用於以下類型的輸入：
- 封鎖條目。
- URL 允許條目，其中 ListSubType 參數值為 AdvancedDelivery。
- IP 位址允許進入。
你不能用這個開關搭配到期日參數。
參數屬性
| 類型: | 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。