Set-TenantAllowBlockListItems

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Online, Security & Compliance, Exchange Online Protection

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Set-TenantAllowBlockListItems, um Einträge in der Zulassungs-/Sperrliste des Mandanten im Microsoft 365 Defender-Portal zu ändern.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Set-TenantAllowBlockListItems
   -Ids <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [<CommonParameters>]

Set-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [<CommonParameters>]

Beschreibung

In den meisten Fällen können Sie die URL-, Datei- oder Absenderwerte eines vorhandenen Eintrags nicht ändern. Die einzige Ausnahme sind Zulässige URL-Einträge für Phishingsimulationen (Action = Allow, ListType = URL und ListSubType = AdvancedDelivery). Weitere Informationen zum Zulassen von URLs für Phishingsimulationen finden Sie unter Konfigurieren der Übermittlung von Phishingsimulationen von Drittanbietern an Benutzer und ungefilterte Nachrichten an SecOps-Postfächer.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()

In diesem Beispiel wird das Ablaufdatum des angegebenen Eintrags geändert.

Beispiel 2

Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021

In diesem Beispiel wird das Ablaufdatum des URL-Zulassungseintrags für die angegebene Phishingsimulations-URL eines Drittanbieters geändert.

Parameter

-Allow

Die Option Zulassen gibt an, dass Sie einen Zulassungseintrag ändern. Sie müssen keinen Wert für diese Option angeben.

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

Der Schalter Blockieren gibt an, dass Sie einen Blockeintrag ändern. Sie müssen bei dieser Option keinen Wert angeben.

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

-Entries

Der Entries-Parameter gibt die Einträge an, die Sie basierend auf dem ListType-Parameterwert ändern möchten. Gültige Werte sind:

FileHash: Der genaue SHA256-Dateihashwert.
Absenderdomänen und E-Mail-Adressen: Der genaue Wert der Domäne oder E-Mail-Adresse.
URL: Der genaue URL-Wert.

Dieser Wert wird in der Value-Eigenschaft des Eintrags in der Ausgabe des Cmdlets Get-TenantAllowBlockListItems angezeigt.

Sie können Werttypen (Datei, Absender oder URL) nicht kombinieren oder Aktionen mit demselben Befehl zulassen und blockieren.

Sie können diesen Parameter nicht mit dem Ids-Parameter verwenden.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ExpirationDate

Der Parameter ExpirationDate filtert die Ergebnisse nach Ablaufdatum in koordinierter Weltzeit (UTC).

Verwenden Sie eine der folgenden Optionen, um einen Datum/Uhrzeit-Wert für diesen Parameter anzugeben:

Geben Sie den Datums-/Uhrzeitwert in UTC an: Beispiel: "2021-05-06 14:30:00z".
Geben Sie den Datums-/Uhrzeitwert als Formel an, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime()die das Datum/die Uhrzeit in Ihrer lokalen Zeitzone in UTC konvertiert: Beispiel: . Weitere Informationen finden Sie unter Get-Date.

Sie können diesen Parameter nicht mit dem Schalter NoExpiration verwenden.

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

-Ids

Der Ids-Parameter gibt die Einträge an, die Sie ändern möchten. Dieser Wert wird in der Identity-Eigenschaft in der Ausgabe des Cmdlets Get-TenantAllowBlockListItems angezeigt.

Ein Beispielwert für diesen Parameter ist RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

Sie können diesen Parameter nicht mit dem Entries-Parameter verwenden.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ListSubType

Der ListSubType-Parameter gibt den Eintrag an, den Sie ändern möchten. Gültige Werte sind:

AdvancedDelivery: Verwenden Sie diesen Wert für URLs der Phishingsimulation. Weitere Informationen finden Sie unter Konfigurieren der Übermittlung von Phishingsimulationen von Drittanbietern an Benutzer und von ungefilterten Nachrichten an SecOps-Postfächer.
Mandant: Dies ist der Standardwert.

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

Der ListType-Parameter gibt den Typ des Eintrags an, den Sie ändern möchten. Gültige Werte sind:

FileHash
Absender
Url

Verwenden Sie den Parameter Entries oder Ids mit diesem Parameter, um den Eintrag selbst zu identifizieren.

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

Der Schalter NoExpiration gibt an, dass der Eintrag niemals ablaufen soll. Sie müssen bei dieser Option keinen Wert angeben.

Dieser Schalter kann mit Blockeinträgen oder url allow-Einträgen verwendet werden, bei denen der ListSubType-Parameterwert AdvancedDelivery ist.

Sie können diesen Schalter nicht mit dem ExpirationDate-Parameter verwenden.

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

-Notes

Der Parameter Notes gibt zusätzliche Informationen zum Objekt an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

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

-OutputJson

Der OutputJson-Schalter gibt an, ob alle Einträge in einem einzelnen JSON-Wert zurückgegeben werden sollen. Sie müssen bei dieser Option keinen Wert angeben.

Sie verwenden diesen Schalter, um zu verhindern, dass der Befehl bei dem ersten Eintrag angehalten wird, der einen Syntaxfehler enthält.

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

Freigeben über