Obtenir des informations de configuration de service à l’aide de EWS dans ExchangeGet service configuration information by using EWS in Exchange

Découvrez comment obtenir des informations de configuration de service de messagerie unifiée, déplacer de stratégie, les conseils de messagerie et les règles de protection d’EWS dans Exchange.Find out how to get service configuration information for UM, policy nudges, mail tips, and protection rules from EWS in Exchange.

Votre application EWS fonctionne avec la messagerie unifiée (MU), déplacer de stratégie, les conseils de messagerie ou les règles de protection ?Does your EWS application work with Unified Messaging (UM), policy nudges, mail tips, or protection rules? Dans ce cas, votre application vous devrez appeler l' opération GetServiceConfiguration pour obtenir les informations de configuration de service qui lui sont nécessaires.If so, your application will need to call the GetServiceConfiguration operation to get the service configuration information that it needs. L’opération GetServiceConfiguration renvoie des informations de configuration spécifiques à chacune de ces fonctionnalités EWS.The GetServiceConfiguration operation returns configuration information that is specific to each of these EWS features.

Notes

L’API managée EWS n’implémente pas cette fonctionnalité.The EWS Managed API does not implement this functionality.

Le tableau 1. Informations de configuration qui renvoie l’opération GetServiceConfigurationTable 1. Configuration information that the GetServiceConfiguration operation returns

Fonctionnalité EWSEWS feature Opération GetServiceConfiguration renvoie...GetServiceConfiguration operation returns…
MESSAGERIE UNIFIÉEUM
  • Une valeur qui indique si la messagerie unifiée est activée.A value that indicates whether UM is enabled.
  • Une valeur qui indique si l’option Lire sur le téléphone est activée.A value that indicates whether play on phone is enabled.
  • La lire sur la chaîne de numérotation téléphonique.The play on phone dial string.
Déplacer de stratégiePolicy nudges
  • Stratégie est déplacée pour l’affichage de votre client.Policy nudges for display in your client.
Conseils de messagerieMail tips
  • Une valeur qui indique si les conseils de la messagerie sont activées.A value that indicates whether mail tips are enabled.
  • Le nombre maximal de destinataires par demande.The maximum number of recipients per request.
  • La taille maximale des messages.The maximum message size.
  • Le seuil de large public.The large audience threshold.
  • Une valeur qui indique si le nombre de destinataires externes est affiché.A value that indicates whether the number of external recipients is shown.
  • Liste des domaines internes.A list of internal domains.
  • Une valeur qui indique si les conseils de stratégie sont activés.A value that indicates whether policy tips are enabled.
  • Le seuil de délimiter large public pour indiquer si votre messagerie est considéré comme un grand nombre de destinataires.The large audience cap threshold for indicating whether your mail is considered to have a large number of recipients.
Règles de protectionProtection rules
  • Programme d’installation des règles de protection de votre client.Protection rules setup for your client.
  • Une liste des domaines internes à votre organisation.A list of domains that are internal to your organization.

Exemple de code : obtenir des informations de configuration de service pour des conseils de messagerie à l’aide de EWSCode example: Get service configuration information for mail tips by using EWS

L’exemple de code suivant utilise l' opération GetServiceConfiguration pour demander des informations de configuration de service pour des conseils de messagerie.The following code example uses the GetServiceConfiguration operation to request service configuration information for mail tips. Vous pouvez demander des informations de configuration de service supplémentaires en ajoutant des éléments de nom de configuration avec des valeurs différentes.You can request additional service configuration information by adding more ConfigurationName elements with different values.

private static void GetServiceConfiguration(ExchangeService service, NetworkCredential creds)
{ 
  // XML for the GetServiceConfiguration request SOAP envelope for mail tips configuration information.
  const string getServiceConfigurationRequest = 
    "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n" +
    "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +
    "               xmlns:m=\"http://schemas.microsoft.com/exchange/services/2006/messages\"\n" +
    "               xmlns:t=\"http://schemas.microsoft.com/exchange/services/2006/types\" \n" +
    "               xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\"\n" +
    "               xmlns:xs=\"http://www.w3.org/2001/XMLSchema\">\n" +
    "  <soap:Header>\n" +
    "    <t:RequestServerVersion Version=\"Exchange2013\" />\n" +
    "  </soap:Header>\n" +
    "  <soap:Body>\n" +
    "    <m:GetServiceConfiguration>\n" +
    "      <m:ActingAs>\n" +
    "        <t:EmailAddress>user1@contoso.com</t:EmailAddress>\n" +
    "        <t:RoutingType>SMTP</t:RoutingType>\n" +
    "      </m:ActingAs>\n" +
    "      <m:RequestedConfiguration>\n" +
    "        <m:ConfigurationName>MailTips</m:ConfigurationName>\n" +
    "      </m:RequestedConfiguration>\n" +
    "    </m:GetServiceConfiguration>\n" +
    "  </soap:Body>\n" +
    "</soap:Envelope>";
  // Encoded GetServiceConfiguration operation request.
  byte[] payload = System.Text.Encoding.UTF8.GetBytes(getServiceConfigurationRequest);
  try
  {
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(service.Url);
    request.AllowAutoRedirect = false;
    request.Credentials = creds;
    request.Method = "POST";
    request.ContentType = "text/xml";
    Stream requestStream = request.GetRequestStream();
    requestStream.Write(payload, 0, payload.Length);
    requestStream.Close();
    HttpWebResponse response = (HttpWebResponse)request.GetResponse();
    if (response.StatusCode == HttpStatusCode.OK)
    {
      Stream responseStream = response.GetResponseStream();
      StreamReader reader = new StreamReader(responseStream);
      string responseFromServer = reader.ReadToEnd();
      Console.WriteLine("You will need to parse this response to get the configuration information:\n\n" + responseFromServer);
      reader.Close();
      responseStream.Close();
    }
    else
      throw new WebException(response.StatusDescription);
          
  }
  catch (WebException e)
  {
    Console.WriteLine(e.Message);
  }
}

Étapes suivantesNext steps

Une fois que vous demandez les informations de configuration de service, utilisez la classe XmlDocument pour charger la réponse XML de sorte que vous pouvez analyser.After you request service configuration information, use the XmlDocument class to load the response XML so that you can parse it. Ensuite, en fonction de votre scénario, vous pouvez effectuer une des options suivantes :Then, depending on your scenario, you can do one of the following:

Voir aussiSee also