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