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、安全性 & 合規性、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 |
-Entry
適用:Exchange Online、安全性 & 合規性、Exchange Online Protection
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、安全性 & 合規性、Exchange Online Protection
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、安全性 & 合規性、Exchange Online Protection
ListSubType 參數會依子類型篩選結果。 有效值為:
- AdvancedDelivery
- 租使用者:此值為預設值。
參數屬性
| 類型: | ListSubType[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ListType
適用:Exchange Online、安全性 & 合規性、Exchange Online Protection
ListType 參數會指定要檢視的清單。 有效值為:
- FileHash
- 寄件者
- URL
- IP
參數屬性
| 類型: | ListType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoExpiration
適用:Exchange Online、安全性 & 合規性、Exchange Online Protection
NoExpiration 參數會依設定為永不過期的專案來篩選結果。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
NoExpiration
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OutputJson
適用:Exchange Online、安全性 & 合規性、Exchange Online Protection
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。