MarkAsJunk-Vorgang

Artikel
03/29/2023

Hier finden Sie Informationen zum EWS-Vorgang MarkAsJunk .

Der MarkAsJunk-Vorgang fügt Benutzer hinzu, entfernt benutzer aus der Liste blockierter E-Mails und verschiebt E-Mail-Nachrichten in den Ordner Junk-Email.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des MarkAsJunk-Vorgangs

Der MarkAsJunk-Vorgang enthält zwei boolesche Optionen, die angeben, ob ein E-Mail-Absender der Liste blockierter Absender hinzugefügt werden soll und ob die Ziel-E-Mail-Nachricht in den Standardordner junk Email oder in den Ordner Posteingang verschoben werden soll. Die Aktionen werden durch die Werte der Attribute IsJunk und MoveItem bestimmt. Im Folgenden sind die möglichen Aktionen aufgeführt, die auf den Wertkombinationen für die Attribute IsJunk und MoveItem basieren:

Wenn das IsJunk-Attribut auf true und das MoveItem-Attribut auf true festgelegt ist, wird der Absender der Ziel-E-Mail-Nachricht der Liste blockierter Absender hinzugefügt, und die E-Mail-Nachricht wird in den Junk-Dmail-Ordner verschoben.
Wenn das IsJunk-Attribut auf true und das MoveItem-Attribut auf false festgelegt ist, wird der Absender der Ziel-E-Mail-Nachricht der Liste blockierter Absender hinzugefügt, und die E-Mail-Nachricht wird nicht aus dem Ordner verschoben.
Wenn das IsJunk-Attribut auf false und das MoveItem-Attribut auf true festgelegt ist, wird der Absender der Ziel-E-Mail-Nachricht aus der Liste blockierter Absender entfernt, und die E-Mail-Nachricht wird in den Ordner Posteingang verschoben.
Wenn das IsJunk-Attribut auf false und das MoveItem-Attribut auf false festgelegt ist, wird der Absender der Ziel-E-Mail-Nachricht aus der Liste blockierter Absender entfernt, und die E-Mail-Nachricht wird nicht aus dem Ordner verschoben.

Wichtig

Der Inhalt der Liste der blockierten Absender kann von EWS nicht erkannt werden. Wenn der Liste der blockierten Absender ein Absender hinzugefügt wird, müssen Sie eine Kopie einer vom blockierten Absender gesendeten E-Mail-Nachricht aufbewahren, um die Blockierung des Absenders in Zukunft aufzuheben.

SOAP-Header des MarkAsJunk-Vorgangs

Der MarkAsJunk-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Headername	Element	Beschreibung
Impersonation	ExchangeImpersonation	Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt. Dieser Header gilt für eine Anforderung.
MailboxCulture	MailboxCulture	Identifiziert die Kultur, wie in RFC 3066 "Tags für die Identifizierung von Sprachen" definiert, die für den Zugriff auf das Postfach verwendet werden soll. Dieser Header gilt für eine Anforderung.
RequestVersion	RequestServerVersion	Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung.
ServerVersion	ServerVersionInfo	Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort.

MarkAsJunk-Vorgangsanforderungsbeispiel: Hinzufügen eines Absenders zur Liste blockierter Absender

Das folgende Beispiel für eine MarkAsJunk-Vorgangsanforderung zeigt, wie sie den Absender einer E-Mail zur Liste blockierter Absender hinzufügen und die E-Mail in den Junk-E-Mail-Ordner verschieben. Der MarkAsJunk-Vorgang akzeptiert den eindeutigen E-Mail-Nachrichtenbezeichner, um die E-Mail zu identifizieren, die verwendet wird, um auf den Absender zu verweisen, der der Liste der blockierten Absender hinzugefügt wird.

Hinweis

Alle Elementbezeichner und Änderungsschlüssel in diesem Artikel wurden gekürzt, um die Lesbarkeit zu erhalten.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <t:RequestServerVersion Version="Exchange2013" />
    </soap:Header>
    <soap:Body>
        <m:MarkAsJunk IsJunk="true" MoveItem="true">
            <m:ItemIds>
                <t:ItemId Id="AAMkAD=" ChangeKey="CQAAABYA" />
            </m:ItemIds>
        </m:MarkAsJunk>
    </soap:Body>
</soap:Envelope>

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche Antwort des MarkAsJunk-Vorgangs

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine MarkAsJunk-Vorgangsanforderung, um einen Absender zur Liste blockierter Absender hinzuzufügen und die E-Mail-Nachricht in den Junk-Email Ordner zu verschieben.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <h:ServerVersionInfo MajorVersion="15" 
                             MinorVersion="0" 
                             MajorBuildNumber="545" 
                             MinorBuildNumber="11" 
                             Version="Exchange2013" 
                             xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                             xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
    </s:Header>
    <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
            xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <m:MarkAsJunkResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                              xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
           <m:ResponseMessages>
               <m:MarkAsJunkResponseMessage ResponseClass="Success">
                  <m:ResponseCode>NoError</m:ResponseCode>
                 <m:MovedItemId Id="AAMkAD=" ChangeKey="CQAAABYu" />
               </m:MarkAsJunkResponseMessage>
           </m:ResponseMessages>
        </m:MarkAsJunkResponse>
    </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

MarkAsJunk-Vorgangsanforderungsbeispiel: Entfernen eines Absenders aus der Liste blockierter Absender

Das folgende Beispiel für eine MarkAsJunk-Vorgangsanforderung zeigt, wie sie den Absender einer E-Mail-Nachricht aus der Liste blockierter Absender entfernen und die E-Mail-Nachricht in den Ordner Posteingang verschieben. Sie müssen eine vom blockierten Absender gesendete E-Mail-Nachricht beibehalten, um den Absender aus der Liste der blockierten Absender zu entfernen. Die E-Mail-Adresse des Absenders ist E-Mail-Nachrichten zugeordnet, die vom Absender gesendet wurden. Das Entfernen eines Absenders aus der Liste blockierter Absender ist nicht erfolgreich, wenn die Referenz-E-Mail-Nachricht nicht mehr im Postfach des Benutzers vorhanden ist. Der Elementbezeichner, der zum Zuordnen einer E-Mail-Nachricht zu ihrem Absender verwendet wird, muss einem Element zugeordnet werden, das im Exchange-Postfach vorhanden ist. Es wird empfohlen, einen ausgeblendeten Ordner zum Speichern von Elementen zu erstellen, die von zuvor blockierten Absendern gesendet wurden, damit die Blockierung der Absender in der Clientanwendung aufgehoben werden kann. Für den Fall, dass ein Element aus dem Exchange-Postfach entfernt wurde, muss ein Administrator die Exchange-Verwaltungskonsole verwenden, um auf die Liste der blockierten Absender zuzugreifen, um einen Absender aus der Liste zu entfernen. Informationen zum Aufheben der Blockierung eines Benutzers mithilfe der Exchange-Verwaltungskonsole finden Sie unter Konfigurieren der Einstellungen für sichere und blockierte Absender in Office 365.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
    </soap:Header>
    <soap:Body>
      <m:MarkAsJunk IsJunk="false" MoveItem="true">
        <m:ItemIds>
          <t:ItemId Id="AAMkAD=" ChangeKey="CQAAABYu" />
        </m:ItemIds>
      </m:MarkAsJunk>
    </soap:Body>
 </soap:Envelope>

Eine erfolgreiche Antwort zum Entfernen eines Absenders aus der Liste blockierter Absender entspricht der Antwort zum Hinzufügen eines Absenders zur Liste blockierter Absender.

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Fehlerantwort des MarkAsJunk-Vorgangs

Das folgende Beispiel zeigt eine Fehlerantwort auf eine MarkAsJunk-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung zum Hinzufügen oder Entfernen eines Absenders zur Liste blockierter Absender, wenn die durch den Elementbezeichner angegebene E-Mail-Nachricht nicht mehr im Postfach vorhanden ist.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="15" 
                         MinorVersion="0" 
                         MajorBuildNumber="545" 
                         MinorBuildNumber="11" 
                         Version="Exchange2013" 
                         xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <m:MarkAsJunkResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:MarkAsJunkResponseMessage ResponseClass="Error">
          <m:MessageText>The specified object was not found in the store.</m:MessageText>
          <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:MarkAsJunkResponseMessage>
      </m:ResponseMessages>
    </m:MarkAsJunkResponse>
  </s:Body>
</s:Envelope>

Der SOAP-Text der Fehlerantwort enthält die folgenden Elemente:

Freigeben über