Add-AESBRole
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.
| Parameter | Datentyp | Optional | Beschreibung |
|---|---|---|---|
| -ConnectionName | String | ✅ | Der Name der Verbindung, über die die Rolle erstellt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet. |
| -RoleName | String | ❌ | Name der Rolle. |
| -Rights | String[] | ❌ | Rechte für die Rolle. |
| -NoConfirm | SwitchParameter | ✅ | Beim Hinzufügen fehlender Abhängigkeitsrechte soll der Benutzer nicht jedes mal bestätigen müssen. |
Beispiele
Beispiel 1: Neue Rolle erstelle
Dieses Beispiel erstellt eine neue Rolle mit dem Namen "MyNewTestRole" und den Rechten für "Workflows".
Beispiel 2: Neue Rolle mit mehreren Rechten erstelle
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
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.
Rückgabewert
Das Cmdlet Add-Role liefert als Ergebnis ein Objekt vom Typ AddRoleResultMessage, dessen Eigenschaft Result den Status der Rollenanlage als Wert des Enums AddRoleResult (z. B. Success, NameNotValid, NameNotUnique, Unknown, RoleIsSystemRole, RoleIsPluginRole) enthält.
Get-AESBRole
Dieses Cmdlet zeigt für eine Rolle die Rechte-Hierarchie und die zugeordneten Benutzer an.
| Parameter | Datentyp | Optional | 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
Beispiel 1: Aufruf mit direkter Übergabe der RoleId
Rückgabewert
Das Cmdlet gibt eine formatierte Zeichenkette mit der Hierarchie der Benutzer und Rechte der angegebenen Rolle zurück.
Get-AESBRoleList
Dieses Cmdlet dient dazu, eine Liste von Rollen aus dem User-Management-System abzurufen und als PowerShell-Objekte auszugeben.
| Parameter | Datentyp | Optional | 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
Rückgabewert
Gibt eine Liste von Rollen als PowerShell-Objekte zurück.
Add-AESBUser
Dieses Cmdlet dient dazu, einen neuen Benutzer anzulegen.