Changes for page UserManagement Cmdlets

Last modified by jklein on 2025/08/13 11:41

From 2.2 to 3.1 From 5.1 to 6.1

From version 3.1

edited by jklein
on 2025/07/17 09:55

Change comment: There is no comment for this version

To version 5.1

edited by jklein
on 2025/07/17 13:19

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -6,12 +6,12 @@
  Falls ein Hauptrecht mit allen Unterrechten hinzugefügt werden soll, muss diese Schreibweise verwendet werden: "Dashboard_*" für das Hauptrecht "Dashboard" mit allen Unterrechten.
--(% style="width:1623.33px" %)
--|=Parameter |=Datentyp|=Optional|=(% style="width: 1069px;" %)Beschreibung
--|-ConnectionName|String|✅|(% style="width:1069px" %)Der Name der Verbindung, über die die Rolle erstellt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
--|-RoleName|String|❌|(% style="width:1069px" %)Name der Rolle.
--|-Rights|String[]|❌|(% style="width:1069px" %)Rechte für die Rolle.
--|-NoConfirm|SwitchParameter|✅|(% style="width:1069px" %)Beim Hinzufügen fehlender Abhängigkeitsrechte soll der Benutzer nicht jedes mal bestätigen müssen.
++(% style="width:1496.33px" %)
++|=Parameter |=Datentyp|=Optional|=(% style="width: 940px;" %)Beschreibung
++|-ConnectionName|String|✅|(% style="width:940px" %)Der Name der Verbindung, über die die Rolle erstellt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-RoleName|String|❌|(% style="width:940px" %)Name der Rolle.
++|-Rights|String[]|❌|(% style="width:940px" %)Rechte für die Rolle.
++|-NoConfirm|SwitchParameter|✅|(% style="width:940px" %)Beim Hinzufügen fehlender Abhängigkeitsrechte soll der Benutzer nicht jedes mal bestätigen müssen.
  === Beispiele ===
@@ -143,7 +143,7 @@
  = Edit-AESBUser =
--Dieses Cmdlet dient dazu, den Vor- und/oder Nachnamen eines Benutzers anhand seiner UserId zu aktualisieren. Es unterstützt verschiedene Parametersätze, um gezielt nur den Vornamen, nur den Nachnamen oder beide zu ändern. Es ist nicht möglich, System-Benutzer (z.B. Operator) oder aus der ACMP importierte ACMP-Benutzer / AD-Benutzer zu bearbeiten.
++Dieses Cmdlet dient dazu, den Vor- und/oder Nachnamen eines Benutzers anhand seiner UserId zu aktualisieren. Es unterstützt verschiedene Parametersätze, um gezielt nur den Vornamen, nur den Nachnamen oder beide zu ändern. Mit diesem Cmdlet ist es nicht möglich, System-Benutzer (z.B. Operator) oder aus der ACMP importierte ACMP-Benutzer/AD-Benutzer zu bearbeiten.
  (% style="width:1952.33px" %)
  |=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
@@ -156,15 +156,8 @@
  Die mit * gekennzeichneten Parameter sind je nach Parametersatz optional oder obligatorisch.
  {{/aagon.infobox}}
--(% class="box infomessage" %)
--(((
--[[image:https://doc.aagon.com/bin/download/XWiki/Aagon Infobox/WebHome/Information.svg||alt="Hinweis" height="32" width="32"]]  **Hinweis: **
++=== Parametersets ===
--Die mit * gekennzeichneten Parameter sind je nach Parametersatz optional oder obligatorisch.
--)))
--
--Parametersets
--
  * FirstNameOnly: Nur der Vorname wird geändert (UserId, FirstName).
  * LastNameOnly: Nur der Nachname wird geändert (UserId, LastName).
  * BothNames: Vor- und Nachname werden geändert (UserId, FirstName, LastName).
@@ -252,7 +252,7 @@
  = Remove-AESBUsers =
--Dieses Cmdlet wird verwendet, um Benutzer aus einem System zu entfernen. Es akzeptiert eine Liste von Benutzer-IDs und führt die Löschung asynchron durch. Es ist nicht möglich, System-Benutzer (z.B. Operator) zu entfernen.
++Dieses Cmdlet wird verwendet, um Benutzer aus einem System zu entfernen. Es akzeptiert eine Liste von UserIds und führt die Löschung asynchron durch. Mit diesem Cmdlet ist es nicht möglich, System-Benutzer (z.B. Operator) zu entfernen.
  (% style="width:1952.33px" %)
  |=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
@@ -275,21 +275,100 @@
  = Set-AESBUserIsEnabled =
++Dieses Cmdlet wird verwendet, um den Aktivierungsstatus von Benutzern in einem System zu ändern. Es unterstützt das Aktivieren und Deaktivieren von Benutzern basierend auf deren UserIds. Mit diesem Cmdlet ist es nicht möglich, System-Benutzer (z.B. Operator) zu aktivieren/deaktivieren.
++(% style="width:1952.33px" %)
++|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|✅|Der Name der Verbindung, über die Benutzer aktiviert / deaktiviert werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserIds|String[]|❌|Eine Liste von Benutzer-IDs, deren Status geändert werden soll.
++|-Enable|SwitchParameter|✅❌*|Aktiviert die angegebenen Benutzer. Kann nicht zusammen mit "-Disable" verwendet werden.
++|-Disable|SwitchParameter|✅❌*|Deaktiviert die angegebenen Benutzer. Kann nicht zusammen mit "-Enable" verwendet werden.
--Dieses Cmdlet wird verwendet, um den Aktivierungsstatus von Benutzern in einem System zu ändern. Es unterstützt das Aktivieren und Deaktivieren von Benutzern basierend auf deren Benutzer-IDs. Es ist nicht möglich, System-Benutzer (z.B. Operator) zu aktivieren/deaktivieren.
++{{aagon.infobox}}
++~* Entweder Enable oder Disable ist erforderlich.
++{{/aagon.infobox}}
++=== Beispiele ===
++Beispiel 1: Benutzer aktivieren
++{{code language="powershell" layout="LINENUMBERS"}}
++#Einen Benutzer aktivieren
++Set-AESBUserIsEnabled -UserIds "ffffffff-ffff-ffff-ffff-ffffffffffff" -Enable
++
++#Mehrere Benutzer aktivieren
++Set-AESBUserIsEnabled -UserIds "ffffffff-ffff-ffff-ffff-fffffffffff1", "ffffffff-ffff-ffff-ffff-fffffffffff2" -Enable
++{{/code}}
++
++Beispiel 2: Benutzer deaktivieren
++
++{{code language="powershell" layout="LINENUMBERS"}}
++#Einen Benutzer deaktivieren
++Set-AESBUserIsEnabled -UserIds "ffffffff-ffff-ffff-ffff-ffffffffffff" -Disable
++
++#Mehrere Benutzer deaktivieren
++Set-AESBUserIsEnabled -UserIds "ffffffff-ffff-ffff-ffff-fffffffffff1", "ffffffff-ffff-ffff-ffff-fffffffffff2" -Disable
++{{/code}}
++
++=== Rückgabewert ===
++
++•    Gibt für jeden erfolgreich verarbeiteten Benutzer ein aktualisiertes UserInfo-Objekt zurück.
++
++= Set-AESBUserPassword =
++
++
++Dieses Cmdlet dient dazu, das Passwort eines Benutzers anhand seiner UserId zu setzen. Das Passwort eines importierten ACMP-Benutzers/AD-Benutzers kann mit diesem Cmdlet nicht geändert werden.
++
  (% style="width:1952.33px" %)
  |=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
--|-ConnectionName|String|✅|Der Name der Verbindung, über die Benutzer gelöscht werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
--|-UserIds|String[]|❌|Eine Liste von Benutzer-IDs der zu entfernenden Benutzer.
++|-ConnectionName|String|✅|Der Name der Verbindung, über die das Benutzer-Passwort geändert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserId|String|❌|Die Benutzer-ID des Benutzers, dessen Passwort geändert werden soll.
++|-Password|Secure String|❌|Das neue Passwort für den Benutzer als Secure String.
++=== Beispiele ===
++Beispiel 1: Passwort für einen Benutzer ändern
++{{code language="powershell"}}
++Set-UserPassword -UserId "ffffffff-ffff-ffff-ffff-ffffffffffff" -Password (ConvertTo-SecureString "NeuesPasswort123!" -AsPlainText -Force)
++{{/code}}
--= Set-AESBUserPassword =
++=== Rückgabewert ===
++•    Bei erfolgreicher Änderung: Ein anonymes Objekt mit UserId und Status = "Success".
++•    Bei Fehlern: PowerShell-Fehlerausgabe mit passender Fehlermeldung.
++
  = Set-AESBUserRoles =
++
++
++Dieses Cmdlet dient dazu, die Rollen eines Benutzers anhand seiner UserId zu setzen. Es ermöglicht das Zuweisen und Entfernen von Rollen für einen bestimmten Benutzer. Mit diesem Cmdlet ist es nicht möglich, System-Benutzern (z.B. Operator) Rollen zuzuweisen.
++
++
++(% style="width:1952.33px" %)
++|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|✅|Der Name der Verbindung, über die die Rollen des Benutzers geändert werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserId|String|❌|Die Benutzer-ID des Benutzers, dessen Passwort geändert werden soll.
++|-Roles|List<RoleInfo>|❌|Die Liste der zuzuweisenden Rollen. Kann leer sein, um alle Rollen zu entfernen.
++
++=== Beispiele ===
++
++Beispiel 1: Rollen für einen Benutzer setzen
++
++{{code language="powershell"}}
++Set-AESBUserRoles -UserId "ffffffff-ffff-ffff-ffff-ffffffffffff" -Roles $rollenListe
++
++{{/code}}
++
++Beispiel 2: Alle Rollen eines Benutzers entfernen
++
++{{code language="powershell"}}
++Set-AESBUserRoles -UserId "ffffffff-ffff-ffff-ffff-ffffffffffff" -Roles @()
++{{/code}}
++
++=== Rückgabewert ===
++
++•    Gibt für jeden erfolgreich verarbeiteten Benutzer die zugewiesenen Rollen (RoleInfo-Objekte) zurück.
++•    Gibt ein Platzhalterobjekt zurück, wenn keine Rollen zugewiesen wurden.
++
++