CreateManagedFolder-Vorgang

  • Artikel

Der CreateManagedFolder-Vorgang erstellt einen verwalteten Ordner im Exchange-Speicher.

Verwenden des CreateManagedFolder-Vorgangs

Der CreateManagedFolder-Vorgang fügt dem Postfach eines Benutzers einen verwalteten benutzerdefinierten Ordner hinzu. Sie können das Cmdlet Get-ManagedFolder der Exchange-Verwaltungsshell verwenden, um verfügbare verwaltete Ordner zu finden, die hinzugefügt werden sollen. Obwohl dieses Cmdlet sowohl verwaltete benutzerdefinierte Ordner als auch verwaltete Standardordner zurückgibt, können nur verwaltete benutzerdefinierte Ordner hinzugefügt werden. Verwaltete benutzerdefinierte Ordner werden durch den Ordnertyp ManagedCustomFolder identifiziert. Der System.DirectoryServices-Namespace enthält auch Typen, mit denen die Namen der verfügbaren verwalteten Ordner ermittelt werden können.

Hinweis

Exchange-Webdienste können nicht verwendet werden, um die Namen der verfügbaren verwalteten Ordner zu finden, die einem Postfach hinzugefügt werden sollen.

Sie können die Vorgänge FindFolder und GetFolder verwenden, um auf verwaltete Ordner zuzugreifen. FindFolder wird verwendet, um nach Ordnern in einem angegebenen übergeordneten Ordner zu suchen. Dies kann verwendet werden, damit verwaltete Ordner in einem Ordner ermittelt werden können, bevor versucht wird, demselben Verzeichnis einen doppelten verwalteten benutzerdefinierten Ordner hinzuzufügen. GetFolder wird nach dem FindFolder-Vorgang verwendet, um weitere Informationen zu einem verwalteten benutzerdefinierten Ordner abzurufen.

HinwBemerkungeneise

Informationen zum Einrichten einer Richtlinie für die Messagingdatensatzverwaltung (Messaging Records Management, MRM) finden Sie unter Erstellen einer Postfachrichtlinie für verwaltete Ordner.

Informationen zum Entfernen verwalteter benutzerdefinierter Ordner aus einem Postfach finden Sie unter Remove-ManagedFolder.

CreateManagedFolder-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel einer CreateManagedFolder-Anforderung zeigt, wie Sie einem Postfach einen verwalteten Ordner namens Test Managed Folder hinzufügen.

Hinweis

Sie können auch den Stellvertretungszugriff verwenden, um verwaltete benutzerdefinierte Ordner hinzuzufügen.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateManagedFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <FolderNames>
        <t:FolderName>Test Managed Folder</t:FolderName>
      </FolderNames>
    </CreateManagedFolder>
  </soap:Body>
</soap:Envelope>

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Weitere Optionen für die Anforderungsmeldung des CreateManagedFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem CreateManagedFolder-Element .

Erfolgreiche CreateManagedFolder-Antwort

Beschreibung

Das folgende Codebeispiel zeigt eine erfolgreiche Antwort auf eine CreateManagedFolder-Anforderung.

Hinweis

Die Id - und ChangeKey-Attributwerte wurden gekürzt, um die Lesbarkeit zu erhalten.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="598" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateManagedFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AS0AdX=" ChangeKey="AACADA=="/>
            </t:Folder>
          </m:Folders>
        </m:CreateManagedFolderResponseMessage>
      </m:ResponseMessages>
    </CreateManagedFolderResponse>
  </soap:Body>
</soap:Envelope>

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Weitere Optionen für die Antwortmeldungen des CreateManagedFolder-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem CreateManagedFolderResponse-Element .

CreateManagedFolder-Fehlerantwort

Beschreibung

Das folgende Codebeispiel zeigt eine Fehlerantwort auf eine CreateManagedFolder-Anforderung.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="598" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateManagedFolderResponseMessage ResponseClass="Error">
          <m:MessageText>A specified managed folder already exists in the mailbox.</m:MessageText>
          <m:ResponseCode>ErrorManagedFolderAlreadyExists</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders/>
        </m:CreateManagedFolderResponseMessage>
      </m:ResponseMessages>
    </CreateManagedFolderResponse>
  </soap:Body>
</soap:Envelope>

Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

Siehe auch

GetFolder-Vorgang

FindFolder-Vorgang

Suchen von Ordnern

Hinzufügen von verwalteten Ordnern