Jan Ulrich Hasecke
2019-12-13 e050b737b4c6cde95282e61d13e79114ca9031cd
source/referenz/hsadmin/domain.rst
@@ -9,24 +9,24 @@
.. option:: domain.search
   Suche Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten
   Suche Domain nach den im Befehlsausdruck angegebenen Feldern und Werten
.. option:: domain.add
   Füge einen neuen Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.
   Füge eine neue Domain nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.
.. option:: domain.update
   Aktualisiere einen Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten.
   Aktualisiere eine Domain nach den im Befehlsausdruck angegebenen Feldern und Werten.
.. option:: domain.remove
   Lösche einen Benutzer nach den im Befehlsausdruck angegebenen Feldern und Werten.
   Lösche eine Domain nach den im Befehlsausdruck angegebenen Feldern und Werten.
Editierbare Felder
==================
Das HSAdmin-Modul ``domain`` kann entsprechend der folgenden Befehlssyntax von :command:`HSADmin` Felder setzen oder verändern::
Das HSAdmin-Modul ``domain`` kann entsprechend der folgenden Befehlssyntax von :command:`HSAdmin` Felder setzen oder verändern::
   domain.function({where:{field:'value',...}, set:{field:'value',...}})
@@ -37,7 +37,7 @@
user
   Name des Domain-Admins
validsubdomainnames
   leichtgewichtige Subdomains in diesem virtual Host des Webservers, gültige Werte: ``*`` für beliebige Subdomains oder eine kommaseparierte Liste: ``www,blog,other``
   leichtgewichtige Subdomains in diesem Virtual-Host des Webservers, gültige Werte: ``*`` für beliebige Subdomains oder eine kommaseparierte Liste: ``www,blog,other``
greylisting
   E-Mails werden verzögert durch den Mailserver angenommen, siehe :term:`Greylisting`. Ist die Option deaktivert, werden E-Mails ohne Verzögerung angenommen.
multiviews
@@ -51,7 +51,9 @@
backupmxforexternalmx
   Der Paket-Hive wird als Weiterleitung (transport) beim Mail-In-Server eingetragen. Ist die Option aktiv, ist der Hostsharing-Mail-In-Server Backup-MX. Der eigentliche Mailserver befindet sich außerhalb der Infrastruktur von Hostsharing (z.B. anderer Provider, DSL-Anschluss mit fester IP)
letsencrypt
   Es wird automatisch ein TLS Zertifikat für diese Domain und alle im Feld „valid subdomain names“ angegebenen Subdomains erzeugt
   Es wird automatisch ein TLS Zertifikat für diese Domain und alle im Feld „validsubdomainnames“ angegebenen Subdomains erzeugt
autoconfig
   Eine Unterstützung für die Konfiguration von E-Mail-Programmen durch die Verfahren "Autoconfig" (Mozilla) und "Autodiscover" (Microsoft) wird für die Domain eingeschaltet
.. note::
@@ -60,8 +62,29 @@
Beispiele
=========
Mit dem folgenden Befehl schalten wir die Domain ``hs-example.de`` auf und ordnen Sie dem Domain-Admin ``xyz00-hsexample`` zu.
.. code-block:: console
    xyz00@hsadmin> domain.add ({set:{name:'hs-example.de',user:'xyz00'}})
    xyz00@hsadmin> domain.add({set:{name:'hs-example.de',user:'xyz00-hsexample'}})
.. todo:: Weitere Beispiele, mindestens noch eins mit where-Kondition
Mit dem Befehl :option:`domain.search` werden alle Informationen zu einer Domain angezeigt.
Die gesuchte Domain wird mit dem Befehlsausdruck ``where`` ausgewählt.
.. code-block:: console
    xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})
Und mit dem Befehl :option:`domain.remove` können wir eine Domain entfernen.
.. code-block:: console
    xyz00@hsadmin> domain.remove({where:{name:'hs-example.de'}})
Mit dem Befehl :option:`domain.update` lassen sich die Einstellungen für eine Domain verändern.
Bei einer Änderung der Domain-Optionen, wie im folgenden Beispiel, müssen immer alle Optionen angegeben werden, die gesetzt sein sollen, da der Befehl die bereits gesetzten Domain-Optionen komplett überschreibt.
.. code-block:: console
    xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:['htdocsfallback','indexes','greylisting','letsencrypt','autoconfig']}})