CreateManagedFolder-Vorgang
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.
Hinweise
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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateManagedFolder xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateManagedFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateManagedFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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: