SessionToken
Für eine Reihe von Powershell-Operationen wird ein so genanntes SessionToken benötigt. Das SessionToken beschreibt eine Anmeldung am System (Benutzer, „Ort“ = Gesellschaft, Werk, Mandant, Verwendungszweck).
Das SessionToken wird beispielsweise für ein Systemstrukturelement innerhalb einer Systemstruktursicht erzeugt.
Wofür das SessionToken erzeugt werden muss, ergibt sich aus der Operation, die danach durchgeführt werden soll.
Um das SessionToken gegen den korrekten Anmeldeknoten auszuführen müssen Sie zunächst Ihre Systemstruktur ermitteln.
Mit folgendem Powershell Befehl wird Ihre Systemstruktur angezeigt:
Select-SystemStructureElement
Anhand der Ausgabe können Sie erkennen welche Elemente auf welchem Knoten vorhanden sind.
Mögliche Varianten für ElementTypeName (Screenshot Spalte ElementType) sind
- System
- Systemkatalog
- Gesellschaftskatalog
- Werkskatalog
- Mandant
Aus der Systemstruktur ergibt sich folgende Tabelle:
| Anmeldeknoten | Wert | Wert | Wert |
|---|---|---|---|
| ElementTypeName | ElementName | ElementName | ElementName |
| System | System | – | – |
| Systemkatalog | Echtdatenbank | – | – |
| Gesellschaftskatalog | SWD | – | – |
| Werkskatalog | HM01 | HM02 | – |
| Mandant | 0001 | L_0001 | 0004 |
Beispiel:
Die Abfrage
$SessionToken = Request-SessionToken -ViewName "Standard" -ElementTypeName "Mandant" -ElementName "0001" -SystemUsages Produktiv
erzeugt ein SessionToken für den Mandanten 0001 in der Systemstruktursicht Standard im Verwendungszweck Produktiv.
Eine nachfolgende Powershell-Operation kann dann beispielsweise die Ausführung eines Skriptes für dieses Element sein. In der nachfolgenden Operation wird das so erzeugte SessionToken mit
-SessionToken $SessionToken
eingebunden.
Beispiel:
Das vorher erzeugte SessionToken wird für die Erzeugung einer Textdatei mit Warnungen für die Migration des angegebenen Messaufbau-Zählpunktes im Produktivsystem des Mandanten 0001 verwendet. Dieser Befehl muss in einer Zeile abgesetzt werden!
Get-MessaufbauMigrationsWarnungen -SessionToken $SessionToken
-Zaehlpunktbezeichnung DE007332476690000000000197000S002
3>&1 > c:tempProtokoll.txt
Eine Auflistung und Erläuterung der möglichen Elemente und Parameter zur Erzeugung von SessionToken finden Sie im Beitrag Schleupen.CS.PI.SB.PowerShell in den Abschnitten Request SessionToken und Request SystemSessionToken.