Release-QuarantineMessage
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Mithilfe des Release-QuarantineMessage-Cmdlets können Sie Nachrichten aus der Quarantäne in der cloudbasierten Organisation freigeben. Sie können Nachrichten an alle ursprünglichen Empfänger oder an bestimmte Empfänger freigeben.
Für Dateien, die von Tresor Anhänge für SharePoint, OneDrive und Microsoft Teams unter Quarantäne gestellt wurden, können Sie die Blockierung der Dateien auf den entsprechenden Teamwebsites und Dokumentbibliotheken mithilfe des Release-QuarantineMessage-Cmdlets aufheben, damit Benutzer auf die Dateien zugreifen, sie freigeben und herunterladen können.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
OrgReleaseToUser
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
OrgReleaseToAll
Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Identities
Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
Release-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Stellen Sie sich folgendes Szenario vor: john@gmail.com Sendet eine Nachricht an faith@contoso.com und john@subsidiary.contoso.com. Gmail teilt diese Nachricht in zwei Kopien auf, die beide als Phishing in Microsoft in die Quarantäne weitergeleitet werden. Ein Administrator gibt diese beiden Meldungen frei an admin@contoso.com. Die erste veröffentlichte Nachricht, die das Administratorpostfach erreicht, wird zugestellt. Die zweite freigegebene Nachricht wird als doppelte Zustellung identifiziert und übersprungen. Nachrichten werden als Duplikate identifiziert, wenn sie dieselbe Nachrichten-ID und Empfangszeit aufweisen.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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
Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>" | Release-QuarantineMessage -User julia@contoso.com
In diesem Beispiel wird das Get-QuarantineMessage Cmdlet verwendet, um die unter Quarantäne gestellte Nachricht mit dem Wert <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> Message-ID für einen ursprünglichen Empfänger julia@contoso.comfreizugeben.
Beispiel 2
Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAll
In diesem Beispiel wird die Nachricht in Quarantäne mit dem angegebenen Identity-Wert für alle ursprünglichen Empfänger freigegeben.
Beispiel 3
Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll
In diesem Beispiel werden alle Nachrichten an alle ursprünglichen Empfänger freigegeben.
Beispiel 4
$q = Get-QuarantineMessage -QuarantineTypes SPOMalware
$q[-1] | Release-QuarantineMessage -ReleaseToAll
In diesem Beispiel wird eine Datei freigegeben, die als Teil von Tresor Anlagen für SharePoint, OneDrive und Microsoft Teams unter Quarantäne gestellt wurde. Der erste Befehl speichert alle unter Quarantäne gestellten Dateien in der Variablen $q. Der zweite Befehl gibt die letzte Datei in der Liste frei. Weitere Informationen zu Elementen in Arrays und Indexnummern finden Sie unter Zugreifen auf und Verwenden von Arrayelementen.
Parameter
-ActionType
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der ActionType-Parameter gibt den Freigabeaktionstyp an. Gültige Werte sind:
- Deny
- Freigeben: Verwenden Sie diesen Wert, um Nachrichten freizugeben oder Anforderungen zum Freigeben von Nachrichten zu genehmigen.
- Anforderung
Parametereigenschaften
| Typ: | ReleaseActionType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AllowSender
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Schalter AllowSender gibt an, dass alle zukünftigen Nachrichten des Absenders nicht unter Quarantäne gestellt werden. Sie müssen keinen Wert für diese Option angeben.
Wenn die Nachricht aufgrund einer Transportregel oder eines blockierten Absenders unter Quarantäne gestellt wurde, können zukünftige Nachrichten dieses Absenders weiterhin blockiert werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.
Verwenden Sie diese Option, wenn Sie versuchen, zuvor freigegebene Nachrichten aus der Quarantäne erneut freizugeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identities
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Parameter Identitäten identifiziert isolierte Nachrichten für Massenvorgänge. Sie identifizieren die Meldungen mithilfe der Syntax: value1,value2,...valueN. Der Wert ist ein eindeutiger Bezeichner für isolierte Nachrichten im Format GUID1\GUID2 (z. B c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7. ).
Sie können den Identitätswert für eine isolierte Nachricht mithilfe des Get-QuarantineMessage-Cmdlets ermitteln.
Wenn Sie diesen Parameter verwenden, ist der Parameter "Identity" erforderlich, aber der Wert wird ignoriert. Verwenden Sie z. B. den Wert 000 für den Parameter Identity.
Parametereigenschaften
| Typ: | QuarantineMessageIdentity[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identities
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
OrgReleaseToAll
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
OrgReleaseToUser
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Parameter Identity gibt an, welche der unter Quarantäne gestellten Nachrichten freigegeben werden soll. Der Wert ist ein eindeutiger Bezeichner für isolierte Nachrichten im Format GUID1\GUID2 (z. B c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7. ).
Sie finden den Identity-Wert für eine Nachricht in Quarantäne mithilfe des Cmdlets Get-QuarantineMessage.
Parametereigenschaften
| Typ: | QuarantineMessageIdentity |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identities
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
OrgReleaseToAll
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
OrgReleaseToUser
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
IdentityOnly
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ReleaseToAll
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Parameter ReleaseToAll gibt die isolierte Nachricht für alle ursprünglichen Empfänger frei. Sie müssen keinen Wert für diese Option angeben.
Dieser Schalter ist für den Quarantänetyp SPOMalware erforderlich.
Wenn Sie zuvor den User-Parameter oder den ReleaseToAll-Schalter verwendet haben, um die isolierte Nachricht für einige oder alle ursprünglichen Empfänger freizugeben, werden diese Empfänger übersprungen, wenn Sie den ReleaseToAll-Schalter erneut verwenden.
Sie können die Option ReleaseToAll und den Parameter User nicht im selben Befehl verwenden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
OrgReleaseToAll
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ReportFalsePositive
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Schalter ReportFalsePositive gibt an, ob die Nachricht als falsch positiv an Microsoft gemeldet werden soll (gute Nachricht als schlecht markiert). Sie müssen keinen Wert für diese Option angeben.
Diese Option ist nur für Spam-Nachrichten in Quarantäne verfügbar.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-User
Anwendbar: Exchange Online, Security & Compliance, Integriertes Sicherheits-Add-On für lokale Postfächer
Der Parameter User gibt die E-Mail-Adresse des Benutzers an, für den die isolierte Nachricht freigegeben werden soll. Mehrere E-Mail-Adressen können durch Kommas getrennt angegeben werden.
Sie können diesen Parameter verwenden, um die Nachricht an die Empfänger der ursprünglichen Nachricht oder an beliebige andere E-Mail-Adressen in der Organization freizugeben.
Wenn Sie zuvor den Parameter ReleaseToAll verwendet haben, um die isolierte Nachricht für alle ursprünglichen Empfänger freizugeben, und später die Nachricht erneut mit dem Parameter User freigeben, werden alle ursprünglichen Empfänger übersprungen, die Sie mit dem Parameter User angeben.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
OrgReleaseToUser
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.
Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.