Changes for page UserManagement Cmdlets

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

From version 1.3
edited by jklein
on 2025/07/17 07:52
Change comment: There is no comment for this version
To version 2.2
edited by jklein
on 2025/07/17 08:41
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -48,12 +48,113 @@
48 48  
49 49  = Get-AESBRole =
50 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 +
51 51  = Get-AESBRoleList =
52 52  
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 +
53 53  = Add-AESBUser =
54 54  
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 +
55 55  = Edit-AESBUser =
56 56  
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 +
57 57  = Get-AESBUsers =
58 58  
59 59  = Remove-AESBUsers =
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community