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.
Impressum
Herausgegeben von:
Schleupen SE
Galmesweg 58
47445 Moers
Telefon: 02841 912 0
Telefax: 02841 912-1903
Zuständig für den Inhalt:
Schleupen SE
©Schleupen SE, Galmesweg 58, 47445 Moers
Haftungsausschluss
Möglicherweise weist das vorliegende Dokument noch Druckfehler oder drucktechnische Mängel auf. In
der Dokumentation verwendete Software-, Hardware- und Herstellerbezeichnungen sind in den
meisten Fällen auch eingetragene Warenzeichen und unterliegen als solche den gesetzlichen
Bestimmungen.
Das vorliegende Dokument ist unverbindlich. Es dient ausschließlich Informationszwecken und nicht als
Grundlage eines späteren Vertrags. Änderungen, Ergänzungen, Streichungen und sonstige
Bearbeitungen dieses Dokuments können jederzeit durch die Schleupen SE nach freiem Ermessen und
ohne vorherige Ankündigung vorgenommen werden.
Obschon die in diesem Dokument enthaltenen Informationen von der Schleupen SE mit größtmöglicher
Sorgfalt erstellt wurden, wird aufgrund des reinen Informationscharakters für die Richtigkeit,
Vollständigkeit, Aktualität und Angemessenheit der Inhalte keinerlei Gewähr übernommen und jegliche
Haftung im gesetzlich zulässigen Umfang ausgeschlossen. Verbindliche Aussagen können stets nur im
Rahmen eines konkreten Auftrags getroffen werden.
Urheberrecht
Die Inhalte des vorliegenden Dokuments sind urheberrechtlich geschützt. Sie dürfen nur nach
vorheriger Genehmigung durch die Schleupen SE verwendet werden. Dies gilt insbesondere für die
Vervielfältigung von Informationen oder Daten, insbesondere die Verwendung von Texten, Textteilen
oder Bildmaterial. Sämtliche Rechte liegen bei der Schleupen SE.
Soweit nicht ausdrücklich von uns zugestanden, verpflichtet eine Verwertung, Weitergabe oder ein
Nachdruck dieser Unterlagen oder ihres Inhalts zu Schadenersatz (BGB, UWG, LitUrhG).