Set-TenantAllowBlockListItems
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/2021In 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 |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für