Get-TenantAllowBlockListItems

模組:

ExchangePowerShell

適用於:

Exchange Online, Security & Compliance, Exchange Online Protection

此指令程式只能在雲端式服務中使用。

使用 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