Wiki source code of UserManagement Cmdlets

Version 2.2 by jklein on 2025/07/17 08:41
Show last authors
1 {{aagon.floatingbox/}}
2
3 = Add-AESBRole =
4
5 Dieses Cmdlet fügt eine neue Rolle mit den angegebenen Rechten hinzu.
6
7 Falls ein Hauptrecht mit allen Unterrechten hinzugefügt werden soll, muss diese Schreibweise verwendet werden: "Dashboard_*" für das Hauptrecht "Dashboard" mit allen Unterrechten.
8
9 (% style="width:1623.33px" %)
10 |=Parameter |=Datentyp|=Optional|=(% style="width: 1069px;" %)Beschreibung
11 |-ConnectionName|String|✅|(% style="width:1069px" %)Der Name der Verbindung, über die die Rolle erstellt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
12 |-RoleName|String|❌|(% style="width:1069px" %)Name der Rolle.
13 |-Rights|String[]|❌|(% style="width:1069px" %)Rechte für die Rolle.
14 |-NoConfirm|SwitchParameter|✅|(% style="width:1069px" %)Beim Hinzufügen fehlender Abhängigkeitsrechte soll der Benutzer nicht jedes mal bestätigen müssen.
15
16 === Beispiele ===
17
18 Beispiel 1: Neue Rolle erstelle
19
20 {{code language="powershell"}}
21 Add-AESBRole -RoleName "MyNewTestRole" -Rights Workflows
22 {{/code}}
23
24 Dieses Beispiel erstellt eine neue Rolle mit dem Namen "MyNewTestRole" und den Rechten für "Workflows".
25
26 Beispiel 2: Neue Rolle mit mehreren Rechten erstelle
27
28 {{code language="powershell"}}
29 Add-AESBRole -RoleName "MyNewTestRole" -Rights Settings, Workflows, PackageManager
30 {{/code}}
31
32 Dieses Beispiel erstellt eine Rolle mit dem Namen "MyNewTestRole" und mehreren Rechten.
33 Falls für die Rollenerstellung ein Abhängigkeitsrecht fehlt, wird der Benutzer gefragt, ob er das Recht noch hinzufügen möchte oder nicht.
34
35 Beispiel 3: Neue Rolle mit mehreren Rechten erstellen und dem optionalen Switchparameter erstelle
36
37 {{code language="powershell"}}
38 Add-AESBRole -RoleName "MyNewTestRole" -Rights Settings, Workflows, PackageManager -NoConfirm
39
40 {{/code}}
41
42 Dieses Beispiel erstellt eine Rolle mit dem Namen "MyNewTestRole" mit mehreren Rechten.
43 Falls der Rolle ein Abhängigkeitsrecht fehlen sollte, wird dieses ohne Zustimmung des Benutzers der Rolle hinzugefügt.
44
45 === Rückgabewert ===
46
47 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.
48
49 = Get-AESBRole =
50
51 Dieses Cmdlet zeigt für eine Rolle die Rechte-Hierarchie und die zugeordneten Benutzer an.
52
53 (% style="width:1952.33px" %)
54 |=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
55 |-ConnectionName|String|✅|Der Name der Verbindung, über die die Informationen zur Rolle abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
56 |-RoleId|String|❌|Die eindeutige ID der Rolle, für die die Benutzer- und Rechte-Hierarchie angezeigt werden soll.
57
58 === Beispiele ===
59
60 Beispiel 1: Aufruf mit direkter Übergabe der RoleId
61
62 {{code language="powershell"}}
63 Get-AESBRole -RoleId "ffffffff-ffff-ffff-ffff-ffffffffffff"
64
65 {{/code}}
66
67 === **Rückgabewert** ===
68
69 Das Cmdlet gibt eine formatierte Zeichenkette mit der Hierarchie der Benutzer und Rechte der angegebenen Rolle zurück.
70
71 = Get-AESBRoleList =
72
73 Dieses Cmdlet dient dazu, eine Liste von Rollen aus dem User-Management-System abzurufen und als PowerShell-Objekte auszugeben.
74
75 (% style="width:1952.33px" %)
76 |=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
77 |-ConnectionName|String|✅|Der Name der Verbindung, über die die Informationen zur Rolle abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
78 |-RoleId|String|❌|Die eindeutige ID der Rolle, für die die Benutzer- und Rechte-Hierarchie angezeigt werden soll.
79
80 === Beispiele ===
81
82 {{code language="powershell"}}
83 Get-AESBRoleList
84 {{/code}}
85
86 === Rückgabewert ===
87
88 Gibt eine Liste von Rollen als PowerShell-Objekte zurück.
89
90 = Add-AESBUser =
91
92 Dieses Cmdlet dient dazu, einen neuen Benutzer anzulegen.
93
94 (% style="width:1952.33px" %)
95 |=Parameter |=Datentyp|=Optional|=(% style="width: 1397px;" %)Beschreibung
96 |-ConnectionName|String|✅|Der Name der Verbindung, über die der Benutzer angelegt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
97 |-UserName|String|❌|Name des neuen Users.
98 |-Password|SecureString|❌|Passwort des neuen Users.
99 |-FirstName|String|✅|Vorname des neuen Users.
100 |-LastName|String|✅|Nachname des neuen Users.
101 |-IsEnabled|Bool|✅|Der neuangelegte Benutzer kann über diesen Parameter aktiviert oder deaktiviert werden. Default ist der User ist aktiviert.
102 |-Roles|String[]|✅|Rechte die dem neuen Benutzer zugewiesen werden können.
103
104 === Beispiele ===
105
106 Beispiel 1: Neuen Benutzer anlegen
107
108 {{code language="powershell"}}
109 Add-AESBUser -Username "TestUser" -Password $password
110 {{/code}}
111
112 Dieses Beispiel legt einen neuen Benutzer mit dem Namen "TestUser" an.
113
114 Beispiel 2: Neuen Benutzer mit weiteren Parametern anlegen
115
116 {{code language="powershell"}}
117 Add-AESBUser -Username "TestUser" -Password $password -FirstName "Test" -LastName "NachnameTest"
118
119 {{/code}}
120
121 Dieses Beispiel legt einen neuen Benutzer mit dem Namen "TestUser" und weiteren Parametern wie FirstName und LastName an.
122
123 Beispiel 3: Neuen Benutzer mit entsprechenden Rollen anlegen
124
125 {{code language="powershell"}}
126 Add-AESBUser -Username "TestUser" -Password $password -FirstName "Test" -LastName "NachnameTest" -Roles ReadOnly
127
128 {{/code}}
129
130 Dieses Beispiel legt einen neuen Benutzer mit dem Namen "TestUser" an und weist ihm die "ReadOnly" Rolle zu.
131
132 Beispiel 4: Neuen nicht aktiven Benutzer anlegen
133
134 {{code language="powershell"}}
135 Add-AESBUser -Username "TestUser" -Password $password -IsEnabled $false
136 {{/code}}
137
138 Dieses Beispiel legt einen neuen Benutzer mit dem Namen "TestUser" aktiviert diesen aber noch nicht.
139
140 === Rückgabewert ===
141
142 Objekt zur weiteren Verarbeitung mit der UserId des neu angelegten Benutzers und einer ResultInfo über das Anlegen des neuen Users.
143
144 = Edit-AESBUser =
145
146
147
148 Dieses Cmdlet dient dazu, den Vor- und/oder Nachnamen eines Benutzers anhand seiner UserId zu aktualisieren.
149
150 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.
151
152
153
154
155
156
157
158 = Get-AESBUsers =
159
160 = Remove-AESBUsers =
161
162 = Set-AESBUserIsEnabled =
163
164 = Set-AESBUserPassword =
165
166 = Set-AESBUserRoles =
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community