Peter Hormanns
2019-12-09 9f8db658bf07b13c3f7051e7bce8b678c2cfd453
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::
@@ -62,6 +64,15 @@
.. code-block:: console
    xyz00@hsadmin> domain.add ({set:{name:'hs-example.de',user:'xyz00-doms'}})
    xyz00@hsadmin> domain.add({set:{name:'hs-example.de',user:'xyz00-hsexample'}})
.. todo:: Weitere Beispiele, mindestens noch eins mit where-Kondition
.. code-block:: console
    xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})
    xyz00@hsadmin> domain.remove({where:{name:'hs-example.de'}})
Achtung: bei einer Änderung der Domain-Optionen müssen immer alle Optionen angegeben werden, die gesetzt sein sollen!
.. code-block:: console
    xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:['htdocsfallback','indexes','greylisting','letsencrypt','autoconfig']}})