Activité Créer la boîte de réception

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • L’activité Créer une boîte de réception crée un nouvel utilisateur Active Directory, si cet utilisateur n’existe pas déjà, ainsi qu’une Microsoft boîte aux lettres Exchange pour cet utilisateur.

    Cette activité implémente la Microsoft commande Exchange New-Mailbox .

    Pour accéder à cette activité dans l’éditeur de workflow, sélectionnez l’onglet Personnalisé , puis accédez à Activités personnalisées > Échanger > Boîte de réception.
    Remarque :
    Cette activité remplace une activité Exchange du même nom disponible dans les versions antérieures à Geneva. Si vous avez créé un workflow dans une version précédente qui utilise l’activité déconseillée, votre workflow continuera de fonctionner normalement après la mise à niveau vers Geneva. Toutefois, tous les nouveaux workflows doivent utiliser la version personnalisée de cette activité. Cette activité a été créée avec le Concepteur d’activité PowerShell, qui permet aux administrateurs de workflow de stocker des variables d’entrée et de sortie dans le bus de données.

    Variables d'entrée

    Tableau 1. Créer des variables d’entrée de boîte de réception
    Variable Description
    hostname Le nom d’hôte du serveur Exchange avec lequel l’activité interagit. Ne pas saisir d’adresse IP dans cette variable.
    domain Le nom du domaine affecté au serveur Exchange.
    Important :
    Le Serveur MID doit faire partie du même domaine que le serveur Exchange.
    first_name Le prénom de l'utilisateur.
    middle_initial Initiale du deuxième prénom de l’utilisateur.
    last_name Le nom de famille de l'utilisateur.
    alias Nom d’affichage de l’adresse de boîte aux lettres, partie de l’adresse de messagerie à gauche du symbole @. Si aucun alias n’est spécifié, l’activité utilise Prénom. Nom de famille en tant qu’alias. L’alias est également utilisé comme nom principal de l’utilisateur (UPN) si aucun n’est spécifié dans les paramètres facultatifs.
    mot de passe Mot de passe à utiliser pour la nouvelle boîte aux lettres. Le mot de passe est chiffré lorsqu’il est envoyé à l’hôte cible.
    paramètres Paramètres facultatifs à transmettre au serveur Exchange écrits en JavaScript Object Notation (JSON). Les activités Exchange ne peuvent pas transmettre de paramètres qui font référence à un objet, tel qu’un objet PSCredential. Le texte brut est automatiquement converti en objets SecureString pour les paramètres qui nécessitent ce type de données.
    La tentative d’enregistrement d’une activité qui spécifie des paramètres en double, y compris des paramètres provenant de variables d’activité, ou un format JSON incorrect entraîne l’affichage d’un message d’avertissement.
    Remarque :
    Lors de la transmission d’un paramètre de commutateur, tel que ForceUpgrade, vous devez utiliser le format "parameter":"true".

    Variables de sortie

    Tableau 2. Créer des variables de sortie de boîte de réception
    Variable Description
    résultat Soit le succès, soit l’échec.
    erreur Message d’erreur en cas d’échec de l’opération.
    sortie Charge utile XML brute du serveur Exchange. Ces données incluent tous les attributs Exchange.

    Conditions

    Tableau 3. Créer des conditions de boîte de réception
    Condition Description
    Succès L’activité a réussi à créer une boîte de réception pour l’utilisateur spécifié. Si aucun compte de diectorat actif n’existait pour cet utilisateur, cette activité a réussi à créer un nouveau compte.
    Échec L’activité n’a pas réussi à créer une nouvelle boîte de réception ou un compte Active Directory pour l’utilisateur spécifié.