Jan Ulrich Hasecke
2019-12-13 e050b737b4c6cde95282e61d13e79114ca9031cd
source/referenz/hsadmin/domain.rst
@@ -52,6 +52,8 @@
   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 „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-doms'}})
    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']}})