Changes for page UserManagement Cmdlets

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

From 4.1 to 5.1

From version 5.1

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

Change comment: There is no comment for this version

To version 11.1

edited by jklein
on 2025/08/13 11:41

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -4,18 +4,24 @@
  Dieses Cmdlet fügt eine neue Rolle mit den angegebenen Rechten hinzu.
--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:999px" %)
++|=Parameter |=Datentyp|=Erforderlich|=(% style="width: 520px;" %)Beschreibung
++|-ConnectionName|String|❌|(% style="width:520px" %)Der Name der Verbindung, über die die Rolle erstellt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-RoleName|String|✅|(% style="width:520px" %)Name der Rolle.
++|-Rights|String[]|(% style="width:88px" %)✅|(% style="width:520px" %)Rechte für die Rolle.
++|-NoConfirm|SwitchParameter|(% style="width:88px" %)❌|(% style="width:520px" %)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.
++{{aagon.infobox}}
++Wenn ein Hauptrecht mit allen Unterrechten hinzugefügt werden soll, muss folgende Schreibweise verwendet werden: "Dashboard_*" für das Hauptrecht "Dashboard" mit allen Unterrechten.
++{{/aagon.infobox}}
++{{aagon.warnungsbox}}
++Falls bei der Ausführung des Cmdlets für die Rollenerstellung ein Abhängigkeitsrecht fehlt, werden Sie gefragt, ob Sie das Recht hinzufügen möchten oder nicht. Wenn Sie dies ablehnen, wird die Rolle nicht erstellt!
++{{/aagon.warnungsbox}}
++
  === Beispiele ===
--Beispiel 1: Neue Rolle erstelle
++Beispiel 1: Neue Rolle erstellen
  {{code language="powershell"}}
  Add-AESBRole -RoleName "MyNewTestRole" -Rights Workflows
@@ -23,7 +23,7 @@
  Dieses Beispiel erstellt eine neue Rolle mit dem Namen "MyNewTestRole" und den Rechten für "Workflows".
--Beispiel 2: Neue Rolle mit mehreren Rechten erstelle
++Beispiel 2: Neue Rolle mit mehreren Rechten erstellen
  {{code language="powershell"}}
  Add-AESBRole -RoleName "MyNewTestRole" -Rights Settings, Workflows, PackageManager
@@ -30,9 +30,8 @@
  {{/code}}
  Dieses Beispiel erstellt eine Rolle mit dem Namen "MyNewTestRole" und mehreren Rechten.
--Falls für die Rollenerstellung ein Abhängigkeitsrecht fehlt, wird der Benutzer gefragt, ob er das Recht noch hinzufügen möchte oder nicht.
--Beispiel 3: Neue Rolle mit mehreren Rechten erstellen und dem optionalen Switchparameter erstelle
++Beispiel 3: Neue Rolle mit mehreren Rechten erstellen und dem optionalen Switchparameter erstellen
  {{code language="powershell"}}
  Add-AESBRole -RoleName "MyNewTestRole" -Rights Settings, Workflows, PackageManager -NoConfirm
@@ -40,7 +40,7 @@
  {{/code}}
  Dieses Beispiel erstellt eine Rolle mit dem Namen "MyNewTestRole" mit mehreren Rechten.
--Falls der Rolle ein Abhängigkeitsrecht fehlen sollte, wird dieses ohne Zustimmung des Benutzers der Rolle hinzugefügt.
++Durch den Parameter {{code language="none"}}-NoConfirm{{/code}} werden notwendige, aber fehlende Abhängigkeitsrechte ohne Zustimmung des Benutzers zur Rolle hinzugefügt.
  === Rückgabewert ===
@@ -51,9 +51,9 @@
  Dieses Cmdlet zeigt für eine Rolle die Rechte-Hierarchie und die zugeordneten Benutzer an.
  (% style="width:1952.33px" %)
--|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
--|-ConnectionName|String|✅|Der Name der Verbindung, über die die Informationen zur Rolle abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
--|-RoleId|String|❌|Die eindeutige ID der Rolle, für die die Benutzer- und Rechte-Hierarchie angezeigt werden soll.
++|=Parameter |=Datentyp|=Erforderlich|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|❌|Der Name der Verbindung, über die die Informationen zur Rolle abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-RoleId|String|✅|Die eindeutige ID der Rolle, für die die Benutzer- und Rechte-Hierarchie angezeigt werden soll.
  === Beispiele ===
@@ -73,9 +73,9 @@
  Dieses Cmdlet dient dazu, eine Liste von Rollen aus dem User-Management-System abzurufen und als PowerShell-Objekte auszugeben.
  (% style="width:1952.33px" %)
--|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
--|-ConnectionName|String|✅|Der Name der Verbindung, über die die Informationen zur Rolle abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
--|-RoleId|String|❌|Die eindeutige ID der Rolle, für die die Benutzer- und Rechte-Hierarchie angezeigt werden soll.
++|=Parameter |=Datentyp|=Erforderlich|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|❌|Der Name der Verbindung, über die die Informationen zur Rolle abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-RoleId|String|✅|Die eindeutige ID der Rolle, für die die Benutzer- und Rechte-Hierarchie angezeigt werden soll.
  === Beispiele ===
@@ -92,14 +92,14 @@
  Dieses Cmdlet dient dazu, einen neuen Benutzer anzulegen.
  (% style="width:1952.33px" %)
--|=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
--|-ConnectionName|String|✅|Der Name der Verbindung, über die der Benutzer angelegt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
--|-UserName|String|❌|Name des neuen Users.
--|-Password|SecureString|❌|Passwort des neuen Users.
--|-FirstName|String|✅|Vorname des neuen Users.
--|-LastName|String|✅|Nachname des neuen Users.
--|-IsEnabled|Bool|✅|Der neuangelegte Benutzer kann über diesen Parameter aktiviert oder deaktiviert werden. Default ist der User ist aktiviert.
--|-Roles|String[]|✅|Rechte die dem neuen Benutzer zugewiesen werden können.
++|=Parameter |=Datentyp|=Erforderlich|=(% style="width: 1397px;" %)Beschreibung
++|-ConnectionName|String|❌|Der Name der Verbindung, über die der Benutzer angelegt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-UserName|String|✅|Name des neuen Users.
++|-Password|SecureString|✅|Passwort des neuen Users.
++|-FirstName|String|❌|Vorname des neuen Users.
++|-LastName|String|❌|Nachname des neuen Users.
++|-IsEnabled|Bool|❌|Der neu angelegte Benutzer kann über diesen Parameter aktiviert oder deaktiviert werden. Default ist der User ist aktiviert.
++|-Roles|String[]|❌|Rechte die dem neuen Benutzer zugewiesen werden können.
  === Beispiele ===
@@ -146,14 +146,14 @@
  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
--|-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.
++|=Parameter |=Datentyp|=Erforderlich|=(% 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.
  {{aagon.infobox}}
--Die mit * gekennzeichneten Parameter sind je nach Parametersatz optional oder obligatorisch.
++Die mit * gekennzeichneten Parameter sind je nach Parametersatz erforderlich oder optional .
  {{/aagon.infobox}}
  === Parametersets ===
@@ -169,11 +169,11 @@
  * Erforderliche Parameter: UserId, FirstName
  {{code language="powershell"}}
--Edit-AESBUser -UserId "benutzer123" -FirstName "Max"
++Edit-AESBUser -UserId "ffffffff-ffff-ffff-ffff-ffffffffffff" -FirstName "Max"
  {{/code}}
--Dieser Befehl ändert den Vornamen des Benutzers mit der ID "benutzer123" zu "Max".
++Dieser Befehl ändert den Vornamen des Benutzers mit der ID "ffffffff-ffff-ffff-ffff-ffffffffffff" zu "Max".
  Beispiel 2: LastNameOnly: Dieser Parametersatz wird verwendet, um ausschließlich den Nachnamen eines Benutzers zu ändern.
@@ -180,11 +180,11 @@
  * Erforderliche Parameter: UserId, LastName
  {{code language="powershell"}}
--Edit-AESBUser -UserId "benutzer123" -LastName "Mustermann"
++Edit-AESBUser -UserId "ffffffff-ffff-ffff-ffff-ffffffffffff" -LastName "Mustermann"
  {{/code}}
--Dieser Befehl ändert den Nachnamen des Benutzers mit der ID "benutzer123" zu "Mustermann".
++Dieser Befehl ändert den Nachnamen des Benutzers mit der ID "ffffffff-ffff-ffff-ffff-ffffffffffff" 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
@@ -204,9 +204,9 @@
  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.
++|=Parameter |=Datentyp|=Erforderlich|=(% 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 ===
@@ -248,9 +248,9 @@
  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
--|-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.
++|=Parameter |=Datentyp|=Erforderlich|=(% 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 ===
@@ -271,9 +271,9 @@
  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.
++|=Parameter |=Datentyp|=Erforderlich|=(% 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.
@@ -313,10 +313,10 @@
  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 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.
++|=Parameter |=Datentyp|=Erforderlich|=(% style="width: 1397px;" %)Beschreibung
++|-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 ===
@@ -339,10 +339,10 @@
  (% 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.
++|=Parameter |=Datentyp|=Erforderlich|=(% 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 ===