Get-TenantAllowBlockListItems
此指令程式只能在雲端式服務中使用。
使用 Get-TenantAllowBlockListItems Cmdlet 在 Microsoft Defender 入口網站中檢視租用戶允許/封鎖清單中的項目。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Expiration (預設值)
Get-TenantAllowBlockListItems
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-Entry <String>]
[-ListSubType <ListSubType[]>]
[-OutputJson]
[<CommonParameters>]
NoExpiration
Get-TenantAllowBlockListItems
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-Entry <String>]
[-ListSubType <ListSubType[]>]
[-OutputJson]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-TenantAllowBlockListItems -ListType Url -Block
此範例會傳回所有封鎖的 URL。
範例 2
Get-TenantAllowBlockListItems -ListType FileHash -Entry "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
此範例會傳回指定檔案雜湊值的資訊。
範例 3
Get-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery
此範例會傳回所有允許的非 Microsoft 網路釣魚模擬 URL 的資訊。 如需詳細資訊,請參閱 設定非 Microsoft 網路釣魚模擬和電子郵件傳遞至 SecOps 信箱的進階傳遞原則。
參數
-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 |
-Entry
適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件
Entry 參數會根據 ListType 參數值來篩選結果。 有效值為:
- FileHash:確切的 SHA256 檔案雜湊值。
- 寄件者:確切的網域或電子郵件地址值。
- Url:確切的 URL 值。
- IP:僅限 IPv6 位址。 冒號十六進位或零壓縮格式或 CIDR IPv6 位址的單一 IPv6 位址範圍從 1 到 128。
此值會顯示在 Get-TenantAllowBlockListItems cmdlet 輸出中項目的 Value 屬性中。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | 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。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Expiration
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListSubType
適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件
ListSubType 參數會依子類型篩選結果。 有效值為:
- AdvancedDelivery
- 租用戶:此值為預設值。
參數屬性
| 類型: | 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 參數會依設定為永不過期的項目來篩選結果。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
NoExpiration
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OutputJson
適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件
OutputJson 參數會指定是否要在單一 JSON 值中傳回所有項目。 您不需要使用此參數指定值。
使用此參數可防止命令在包含語法錯誤的第一個項目上停止。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | 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。