>From 7af3675920089d830b6b7bd12fc8c54fe1b8eb25 Mon Sep 17 00:00:00 2001 From: Rowland Penny Date: Wed, 29 Jun 2016 12:21:12 +0100 Subject: [PATCH 5/5] samba-tool domain provision, add examples to help. Signed-off-by: Rowland Penny --- python/samba/netcmd/domain.py | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/python/samba/netcmd/domain.py b/python/samba/netcmd/domain.py index ae26b1c..24eff06 100644 --- a/python/samba/netcmd/domain.py +++ b/python/samba/netcmd/domain.py @@ -161,7 +161,39 @@ class cmd_domain_info(Command): class cmd_domain_provision(Command): - """Provision a domain.""" + """Provision a domain. + +This command provisions a new Active Directory domain. You must supply the +Realm name and the NetBIOS domain name via '--realm=' & '--domain=", xattr's +will be used if your system supports them. + +You can run the command interactively or supply options with the command. + +Example1: +samba-tool domain provision --realm=SAMBA.EXAMPLE.COM --domain=SAMBA \ +--use-rfc2307 --adminpass=P4$$word + +Example1 will provision a new domain, using the realm name 'SAMBA.EXAMPLE.COM' +and the NetBIOS (workgroup) name 'SAMBA', it will also use RFC2307 attributes. +It will use the default 2008_R2 function level and the internal DNS server. + +Example2: +samba-tool domain provision --realm=SAMBA.EXAMPLE.COM --doman=SAMBA \ +--use-rfc2307 --dns-backend= BIND9_DLZ --adminpass=P4$$word + +Example2 will provision a new domain, using the realm name 'SAMBA.EXAMPLE.COM' +and the NetBIOS (workgroup) name 'SAMBA', it will also use RFC2307 attributes. +It will use the default 2008_R2 function level and Bind9 for the DNS server. + +Example3: +samba-tool domain provision --realm=SAMBA.EXAMPLE.COM --domain=SAMBA \ +--interactive + +Example3 will provision a new domain, using the realm name 'SAMBA.EXAMPLE.COM' +and the NetBIOS (workgroup) name 'SAMBA', it will ask for further information +via the command line. + +""" synopsis = "%prog [options]" -- 2.1.4