From: Rob van der Linde <rob@catalyst.net.nz>
Date: Mon, 25 Mar 2024 05:07:02 +0000 (+1300)
Subject: netcmd: docs: add documentation for service-account base command
X-Git-Tag: tdb-1.4.11~1338
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=03a6740a90b2c6e5bdb7182444b5eb17b3fb98c1;p=thirdparty%2Fsamba.git

netcmd: docs: add documentation for service-account base command

Signed-off-by: Rob van der Linde <rob@catalyst.net.nz>
Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
---

diff --git a/docs-xml/manpages/samba-tool.8.xml b/docs-xml/manpages/samba-tool.8.xml
index e6c0c08c240..6ca978862c9 100644
--- a/docs-xml/manpages/samba-tool.8.xml
+++ b/docs-xml/manpages/samba-tool.8.xml
@@ -1635,6 +1635,136 @@
 	</variablelist>
 </refsect3>
 
+<refsect2>
+	<title>service-account</title>
+	<para>Service account management.</para>
+</refsect2>
+
+<refsect3>
+	<title>service-account list</title>
+	<para>List service accounts on the domain.</para>
+	<variablelist>
+		<varlistentry>
+			<term>-H, --URL</term>
+			<listitem><para>
+				LDB URL for database or target server.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--json</term>
+			<listitem><para>
+				View service accounts as JSON instead of a list.
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect3>
+
+<refsect3>
+	<title>service-account view</title>
+	<para>View a single service account on the domain.</para>
+	<variablelist>
+		<varlistentry>
+			<term>-H, --URL</term>
+			<listitem><para>
+				LDB URL for database or target server.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--name</term>
+			<listitem><para>
+				Account name of service account to view (required).
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect3>
+
+<refsect3>
+	<title>service-account create</title>
+	<para>Create a new service account on the domain.</para>
+	<variablelist>
+		<varlistentry>
+			<term>-H, --URL</term>
+			<listitem><para>
+				LDB URL for database or target server.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--name</term>
+			<listitem><para>
+				Account name of service account (required).
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--dns-host-name</term>
+			<listitem><para>
+				DNS hostname of this service account (required).
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--group-msa-membership</term>
+			<listitem><para>
+				Optional Group MSA Membership SDDL.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--managed-password-interval</term>
+			<listitem><para>
+				Managed password refresh interval in days.
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect3>
+
+<refsect3>
+	<title>service-account modify</title>
+	<para>Modify an existing service account on the domain.</para>
+	<variablelist>
+		<varlistentry>
+			<term>-H, --URL</term>
+			<listitem><para>
+				LDB URL for database or target server.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--name</term>
+			<listitem><para>
+				Account name of service account (required).
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--dns-host-name</term>
+			<listitem><para>
+				Update DNS hostname of this service account.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--group-msa-membership</term>
+			<listitem><para>
+				Update Group MSA Membership SDDL.
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect3>
+
+<refsect3>
+	<title>service-account delete</title>
+	<para>Delete a service accounts on the domain.</para>
+	<variablelist>
+		<varlistentry>
+			<term>-H, --URL</term>
+			<listitem><para>
+				LDB URL for database or target server.
+			</para></listitem>
+		</varlistentry>
+		<varlistentry>
+			<term>--name</term>
+			<listitem><para>
+				Account name of service account to delete.
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect3>
+
 <refsect3>
 	<title>domain classicupgrade [options] <replaceable>classic_smb_conf</replaceable></title>
 	<para>Upgrade from Samba classic (NT4-like) database to Samba AD DC