Benutzerkonto erstellen

Wie du mit dieser Aktion ein lokales Benutzerkonto auf dem Gerät anlegst, welche Einstellungen es gibt und wann der Schritt fehlschlägt.

Mit dieser Aktion legst du ein lokales Konto im Betriebssystem des Geräts an und nimmst es auf Wunsch in die Administratorgruppe auf. Das Gerät muss dafür online sein.

Konfigurationsfelder

Feld	Typ	Pflicht	Standard	Beschreibung
Kontoname	Text	Ja	—	Name des lokalen Kontos. Erlaubt sind Buchstaben, Ziffern, Punkte, Unterstriche und Bindestriche. Das erste Zeichen muss ein Buchstabe oder eine Ziffer sein, höchstens 20 Zeichen. Variablen `${{ … }}` sind erlaubt. Einen Namen mit Variable prüft octoja erst zur Laufzeit, nachdem sie aufgelöst ist.
Kennwort	Kennwort	Ja	—	Kennwort für ein neues Konto. Es muss der Kennwortrichtlinie des Geräts entsprechen. octoja speichert es, zeigt es aber nie wieder an. Bearbeitest du den Schritt später, ist das Feld leer. Lässt du es leer, bleibt das gespeicherte Kennwort erhalten. Eine Variable im Feld wird zur Laufzeit aufgelöst.
Administrator	Schalter	Nein	Aus	Nimmt das Konto in Administratoren (Windows), sudo bzw. wheel (Linux) oder admin (macOS) auf.

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja
Linux	Ja
macOS	Ja

So sieht das neue Konto aus:

Plattform	Neues Konto
Windows	Lokales Konto in der integrierten Gruppe Benutzer. Weder Konto noch Kennwort laufen ab.
Linux	Konto mit Home-Verzeichnis. Mit Administrator kommt das Konto in die Gruppe `sudo` oder, falls es die nicht gibt, in `wheel`.
macOS	Lokales Konto. Mit Administrator zusätzlich Mitglied von `admin`.

Ausgaben

Ausgabe	Beschreibung
`created`	`true`, wenn dieser Lauf das Konto angelegt hat, `false`, wenn es schon existierte.
`action`	Aktion: `created` oder `alreadyExists`.

Ergebnisverhalten

Situation	Ergebnis
Konto existiert noch nicht	Erfolgreich, `created` = `true`.
Konto existiert schon	Erfolgreich, `created` = `false`, `action` = `alreadyExists`. Das Kennwort wird nicht zurückgesetzt. Der Schritt stellt nur die Gruppen sicher: unter Windows die Gruppe Benutzer, mit Administrator die Administratorgruppe.
Kennwort verstößt gegen die Kennwortrichtlinie oder das Anlegen scheitert	Fehlgeschlagen. Die Fehlermeldung des Geräts steht im Schrittergebnis.
Administrator eingeschaltet, aber auf dem Linux-Gerät gibt es weder `sudo` noch `wheel`	Fehlgeschlagen.
Aufgelöster Kontoname verstößt gegen die Namensregeln	Fehlgeschlagen mit Der aufgelöste Kontoname ist kein zulässiger lokaler Kontoname.
Kennwort leer oder mit einer Variable, die sich nicht auflösen ließ	Fehlgeschlagen mit Das Kennwort ist leer oder enthält eine Variable, die nicht aufgelöst werden konnte.
Gerät beim Start des Schritts offline	Gerät offline. Je nach Wenn Gerät offline endet der Lauf mit diesem Status oder der Schritt wird übersprungen.

Gruppen fügt der Schritt immer nur hinzu. Schaltest du Administrator später aus, bleibt ein vorhandenes Konto in der Administratorgruppe. Ein Konto löscht der Schritt nie.

Unter Linux kann es passieren, dass das Konto angelegt wird, das Kennwort aber nicht gesetzt werden kann. Das Konto bleibt dann auf dem Gerät, und spätere Läufe melden es als vorhanden, ohne das Kennwort zu setzen. Setze das Kennwort in diesem Fall direkt auf dem Gerät oder entferne das Konto, bevor du den Schritt erneut ausführst.

Siehe auch: Eine Automatisierung erstellen · Benutzerkonto deaktivieren · Benutzerkonto-Audit

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen