Jan Ulrich Hasecke
2019-12-20 21f8b62c5d0aa91f00fce28b4a5bc8433ebe1c8d
commit | author | age
8d081a 1 .. _kap-modul-emailalias:
0a126d 2
8d081a 3 ================
JUH 4 Modul emailalias
5 ================
0a126d 6
e50d93 7 Mit diesem Modul können Sie ein E-Mail-Alias setzen.
JUH 8 Ein typischer Anwendungsfall wird in :numref:`kap-email-alias` beschrieben.
72c372 9
JUH 10
8d081a 11 Funktionen
JUH 12 ==========
0a126d 13
8d081a 14 .. option:: emailalias.search
JUH 15
16    Suche E-Mail-Alias nach den im Befehlsausdruck angegebenen Feldern und Werten
17
18 .. option:: emailalias.add
19
20    Füge eine neue E-Mail-Alias nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.
21
22 .. option:: emailalias.update
23
24    Aktualisiere eine E-Mail-Alias nach den im Befehlsausdruck angegebenen Feldern und Werten.
25
26 .. option:: emailalias.remove
27
28    Lösche eine E-Mail-Alias nach den im Befehlsausdruck angegebenen Feldern und Werten.
29    
30 Editierbare Felder
31 ==================
32
222551 33 Das HSAdmin-Modul ``emailalias`` kann entsprechend der folgenden Befehlssyntax von :command:`HSAdmin` Felder setzen oder verändern::
8d081a 34
JUH 35    emailalias.function({where:{field:'value',...}, set:{field:'value',...}})
36
37 Im Modul ``emailalias`` stehen folgende Felder zur Verfügung.
38
39 name
40    Name des E-Mail-Alias
41 target
42    Ziel einer E-Mail-Adresse; mehrere Ziele werden durch Kommata getrennt
43
44 Beispiele
45 =========
0a126d 46
e50d93 47 Das folgende E-Mail-Alias überschreibt die Voreinstellung für den Paket-Admin ``xyz00``.
JUH 48 E-Mails an diesen Benutzer landen nicht mehr in seinem Postfach, sondern werden an die E-Mailadresse ``webmaster@hs-example.de`` weitergeleitet.
49
0a126d 50 .. code-block:: console
JUH 51
52     xyz00@hsadmin> emailalias.add ({set:{name:'xyz00',target:'webmaster@hs-example.de'}})
53
e50d93 54 In dem nächsten beiden Beispielen wird zunächst nach der Konfiguration für das E-Mail-Alias ``xyz00`` gesucht.
JUH 55 Anschließend wird ein Postfach ``xyz00-mailbox`` zusätzlich zu der bereits eingetragenen E-Mail-Adresse hinzugefügt.
56 Da das Programm die Felder komplett überschreibt, müssen alle Werte angegeben werden.
57
9f8db6 58 .. code-block:: console
8d081a 59
9f8db6 60     xyz00@hsadmin> emailalias.search ({where:{name:'xyz00'}})
e50d93 61     xyz00@hsadmin> emailalias.update ({where:{name:'xyz00'},set:{target:'xyz00-mailbox,webmaster@hs-example.de'}})
JUH 62
21f8b6 63 Im letzten Beispiel wird das E-Mail-Alias wieder gelöscht, sodass E-Mails an den Paket-Admin wieder an sein Postfach ausgeliefert werden.
e50d93 64
JUH 65
66 .. code-block:: console
67         
9f8db6 68     xyz00@hsadmin> emailalias.remove ({where:{name:'xyz00'}})
72c372 69