Änderungen von Dokument UserManagement Cmdlets

Zuletzt geändert von jklein am 2025/08/13 11:41

Von 2.1 nach 2.2 Von 3.1 nach 4.1

Von Version 2.2

bearbeitet von jklein
am 2025/07/17 08:41

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 3.1

bearbeitet von jklein
am 2025/07/17 09:55

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -143,24 +143,153 @@
  = 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.
++(% style="width:1952.33px" %)
++|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|✅|Der Name der Verbindung, über die der Benutzer bearbeitet werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserId|String|❌|Die eindeutige Kennung des Benutzers, dessen Daten geändert werden sollen.
++|-FirstName|String|✅❌*|Der neue Vorname des Benutzers.
++|-LastName|String|✅❌*|Der neue Nachname des Benutzers.
--Dieses Cmdlet dient dazu, den Vor- und/oder Nachnamen eines Benutzers anhand seiner UserId zu aktualisieren.
++{{aagon.infobox}}
++Die mit * gekennzeichneten Parameter sind je nach Parametersatz optional oder obligatorisch.
++{{/aagon.infobox}}
--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.
++(% class="box infomessage" %)
++(((
++[[image:https://doc.aagon.com/bin/download/XWiki/Aagon Infobox/WebHome/Information.svg||alt="Hinweis" height="32" width="32"]]  **Hinweis: **
++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).
++=== Beispiele ===
++Beispiel 1: FirstNameOnly: Dieser Parametersatz wird verwendet, um ausschließlich den Vornamen eines Benutzers zu ändern.
++* Erforderliche Parameter: UserId, FirstName
++{{code language="powershell"}}
++Edit-AESBUser -UserId "benutzer123" -FirstName "Max"
++
++{{/code}}
++
++Dieser Befehl ändert den Vornamen des Benutzers mit der ID "benutzer123" zu "Max".
++
++Beispiel 2: LastNameOnly: Dieser Parametersatz wird verwendet, um ausschließlich den Nachnamen eines Benutzers zu ändern.
++
++* Erforderliche Parameter: UserId, LastName
++
++{{code language="powershell"}}
++Edit-AESBUser -UserId "benutzer123" -LastName "Mustermann"
++
++{{/code}}
++
++Dieser Befehl ändert den Nachnamen des Benutzers mit der ID "benutzer123" zu "Mustermann".
++
++Beispiel 3: BothNames: Dieser Parametersatz wird verwendet, um sowohl den Vor- als auch den Nachnamen eines Benutzers gleichzeitig zu ändern.
++Erforderliche Parameter: UserId, FirstName, LastName
++
++{{code language="powershell"}}
++Edit-AESBUser -UserId "benutzer123" -FirstName "Max" -LastName "Mustermann"
++{{/code}}
++
++Dieser Befehl ändert den Vornamen des Benutzers mit der ID "benutzer123" zu "Max" und den Nachnamen zu "Mustermann".
++
++=== Rückgabewert ===
++
++Bei Erfolg gibt das Cmdlet ein Objekt mit den Eigenschaften UserId und Result "Success" zurück. Bei Fehlern wird eine Exception ausgelöst.
++
  = Get-AESBUsers =
++Dieses Cmdlet wird verwendet, um Benutzerinformationen aus einem System abzurufen. Es unterstützt die Angabe von UserIds und gibt detaillierte Informationen zu den Benutzern zurück, einschließlich Rollen, Rechte und Domäneninformationen.
++
++(% style="width:1952.33px" %)
++|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|✅|Der Name der Verbindung, über die Benutzer-Informationen abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserIds|String[]|❌|Eine Liste von Benutzern, deren Daten geändert werden sollen.
++
++=== Beispiele ===
++
++Beispiel 1: Abrufen aller Benutzer
++
++{{code language="powershell"}}
++Get-AESBUsers
++{{/code}}
++
++Beispiel 2: Abrufen spezifischer Benutzer
++
++{{code language="powershell"}}
++Get-AESBUsers -UserIds "ffffffff-ffff-ffff-ffff-ffffffffffff", "ffffffff-ffff-ffff-ffff-ffffffffffff"
++
++{{/code}}
++
++=== Rückgabewert ===
++
++Das Cmdlet gibt eine Liste von UserInformation-Objekten zurück. Jedes Objekt enthält folgende Eigenschaften:
++•    UserId: Die eindeutige ID des Benutzers.
++•    Username: Der Benutzername.
++•    FirstName: Der Vorname des Benutzers.
++•    LastName: Der Nachname des Benutzers.
++•    UserStatus: Der Status des Benutzers (z. B. Aktiviert, Deaktiviert, Gesperrt).
++•    UserType: Der Typ des Benutzers (z. B. Normal, System).
++•    Roles: Eine Liste der Rollen des Benutzers.
++•    Rights: Eine Liste der Rechte des Benutzers.
++•    DomainName: Der Name der Domäne, zu der der Benutzer gehört.
++•    DomainId: Die ID der Domäne.
++•    ProcessStatus: Der Verarbeitungsstatus (z. B. Erfolgreich, Fehler).
++
++=== Fehlerbehandlung ===
++
++•    Warnungen: Wenn keine Benutzer gefunden werden, wird eine Warnung ausgegeben.
++•    Fehler: Bei schwerwiegenden Fehlern wird ein TerminatingError ausgelöst.
++
  = 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.
++
++(% 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.
++
++=== Beispiele ===
++
++Beispiel 1: Entfernen mehrerer Benutzer
++
++{{code language="powershell"}}
++Remove-AESBUsers -UserIds "ffffffff-ffff-ffff-ffff-fffffffffff1", "ffffffff-ffff-ffff-ffff-fffffffffff2", "ffffffff-ffff-ffff-ffff-fffffffffff3"
++{{/code}}
++
++=== Rückgabewert ===
++
++Das Cmdlet gibt eine Liste von UserDeletionResult-Objekten zurück, die die folgenden Eigenschaften enthalten:
++•    UserId: Die ID des gelöschten Benutzers.
++•    Result: Das Ergebnis der Löschung (z. B. Success, UserNotFound, SystemUser).
++
  = 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 Benutzer-IDs. Es ist 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 gelöscht werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserIds|String[]|❌|Eine Liste von Benutzer-IDs der zu entfernenden Benutzer.
++
++
++
++
++
  = Set-AESBUserPassword =
  = Set-AESBUserRoles =