Get-TenantAllowBlockListItems
此指令程式只能在雲端式服務中使用。
使用 Get-TenantAllowBlockListItems Cmdlet 在 Microsoft 365 Defender 入口網站中檢視租使用者允許/封鎖清單中的專案。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Get-TenantAllowBlockListItems
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-Entry <String>]
[-ListSubType <ListSubType[]>]
[-OutputJson]
[<CommonParameters>]
Get-TenantAllowBlockListItems
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-Entry <String>]
[-ListSubType <ListSubType[]>]
[-OutputJson]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 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
此範例會傳回所有允許的協力廠商網路釣魚模擬 URL 的資訊。 如需詳細資訊,請參閱 設定將協力廠商網路釣魚模擬傳遞給使用者,以及將未篩選的郵件傳遞至 SecOps 信箱。
參數
-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 |
-Entry
Entry 參數會根據 ListType 參數值來篩選結果。 有效值為:
- FileHash:確切的 SHA256 檔案雜湊值。
- 寄件者:確切的網域或電子郵件地址值。
- URL:確切的 URL 值。
這個值會顯示在 Get-TenantAllowBlockListItems Cmdlet 輸出中專案的 Value 屬性中。
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 |
-ExpirationDate
ExpirationDate 參數會依國際標準時間 (UTC) 中的到期日來篩選結果。
若要指定這個參數的日期/時間值,請使用下列其中一個選項︰
- 以 UTC 指定日期/時間值:例如。
"2021-05-06 14:30:00z"
- 將日期/時間值指定為公式,將您當地時區的日期/時間轉換成 UTC:例如。
(Get-Date "5/6/2020 9:30 AM").ToUniversalTime()
如需詳細資訊,請參閱 Get-Date。
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 |
-ListSubType
ListSubType 參數會依子類型篩選結果。 有效值為:
- AdvancedDelivery
- 租使用者:這是預設值。
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
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 參數會依設定為永不過期的專案來篩選結果。 您不需要使用此參數指定值。
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 |
-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 |