Freigeben über

Erstellen von Kontaktgruppen mithilfe von EWS in Exchange

  • Artikel

Erfahren Sie, wie Sie eine Kontaktgruppe mithilfe der verwalteten EWS-API oder EWS in Exchange erstellen.

Sie können eine Kontaktgruppe erstellen, bei der es sich um eine private Verteilergruppe handelt, indem Sie die verwaltete EWS-API oder EWS verwenden. Verwenden Sie zum Erstellen von Kontaktgruppen die Methoden in der verwalteten ContactGroup EWS-API-Klasse oder den EWS-Vorgang CreateItem .

Beachten Sie, dass Sie die verwaltete EWS-API oder EWS nicht verwenden können, um eine universelle Verteilergruppe oder Sicherheitsgruppe zu erstellen. Zum Erstellen einer universellen Verteilergruppe oder Sicherheitsgruppe können Sie das Exchange-Verwaltungsshell-Cmdlet New-DistributionGroup verwenden.

Erstellen einer Kontaktgruppe mithilfe der verwalteten EWS-API

Um eine Kontaktgruppe zu erstellen, benötigen Sie nur einige Informationen: einen Namen für die Gruppe und die Mitglieder, die der Gruppe hinzugefügt werden sollen. Das folgende Beispiel zeigt, wie Sie eine einfache Kontaktgruppe erstellen, die einige Gruppenmitglieder enthält.

// Create a new contact group object.
ContactGroup myContactGroup = new ContactGroup(service);
// Give the group a name.
myContactGroup.DisplayName = "My Contact Group";
// Add some members to the group.
myContactGroup.Members.Add(new GroupMember("sadie@contoso.com"));
myContactGroup.Members.Add(new GroupMember("alfred@contoso.com"));
// Save the group.
myContactGroup.Save();

Erstellen einer Kontaktgruppe mithilfe von EWS

Es kann ein paar weitere Codezeilen dauern, aber Sie können eine Kontaktgruppe erstellen, indem Sie den EWS-Vorgang CreateItem verwenden. Das folgende XML-Anforderungsbeispiel zeigt, wie Sie eine Kontaktgruppe erstellen können. Dies ist auch die XML-Anforderung, die gesendet wird, wenn Sie die verwaltete EWS-API verwenden, um eine Kontaktgruppe zu erstellen.

<?xml version="1.0" encoding="utf-8"?>
   <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
MessageDisposition="SaveOnly">
      <Items xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
         <DistributionList xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
            <DisplayName xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
               My Contact Group
            </DisplayName>
            <Members xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
               <Member xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                  <Mailbox xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                     <EmailAddress xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                        sadie@contoso.com
                     </EmailAddress>
                  </Mailbox>
               </Member>
               <Member xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                  <Mailbox xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                     <EmailAddress xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                        alfred@contoso.com
                     </EmailAddress>
                  </Mailbox>
               </Member>
            </Members>
         </DistributionList>
      </Items>
   </CreateItem>

Es folgt ein Beispiel für eine erfolgreiche XML-Antwort auf die Anforderung. Beachten Sie, dass die zurückgegebenen Werte eine Element-ID für die neue Kontaktgruppe und einen Änderungsschlüssel enthalten, den Sie in anderen Code verwenden können, um die Kontaktgruppe zu ändern oder die Gruppe zu erweitern, um die Mitglieder anzuzeigen. Die Element-ID wird aus Gründen der Lesbarkeit gekürzt.

<?xml version="1.0" encoding="utf-8"?>
   <CreateItemResponse xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessages xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
         <CreateItemResponseMessage ResponseClass="Success" 
             xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
            <ResponseCode xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
               NoError
            </ResponseCode>
            <Items xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
               <DistributionList xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                  <ItemId xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                          Id="AAMkADBlY…" 
                          ChangeKey="EgAAABYAAAAD7hO1SJPWTbICFWZ4U3NMAABXzQiK" />
               </DistributionList>
            </Items>
         </CreateItemResponseMessage>
      </ResponseMessages>
   </CreateItemResponse>

Siehe auch