Skip to main content

Power Shell

Hiermit können beliebige PowerShell Skripte, lokal auf dem Server oder auf remote Clients, ausgeführt werden.

PowerShellW10.png

Konfiguration - Pluginintegration
  • Assembly: PowerShellPlugin
  • Name: RUN_POWERSHELL_SCRIPT (wird übersetzt)
  • Icon: scroll_run.png

Der Aufruf des Power Shell Plugins lässt sich unterschiedlich konfigurieren. Somit ist es möglich das Plug-in mehrfach, mit unterschiedlichen Konfigurationen und Berechtigungen einzubinden. Jede Konfiguration kann den Aufruf eines beliebigen Scripts enthalten. Zur Darstellung von Scriptsammlungen z.B. für bestimmte Benutzergruppen kann jede Konfiguration auf ein beliebiges Script-Verzeichnis zeigen. Dabei sind beliebig viele Unterverzeichnisse möglich. Das ermöglicht eine granulare Rechteverteilung auf bestimmte AD-Gruppen. Zusätzlich unterstützt das Plugin die Ersetzungsvariable {COMPUTERNAME} innerhalb der Funktionsparameter für die Ausführung einzelner Scripte. Folgend werden einige Konfigurationsbeispiele dargestellt.

Unterstützte Funktionen (Function)
  • ALLOW_REMOVE_FROM_COLLECTION: Wenn diese Funktion ausgewählt ist, erscheint im Kontextmenü der Eintrag zum Entfernen eines Computerobjekts aus der jeweiligen Sammlung.
Konfiguration - Global
  • EXECUTE: Es wird lediglich eine Meldung über Erfolg oder Misserfolg ausgegeben.
  • GET_RESULT: Das Scriptergebnis wird in einer Textbox dargestellt.
  • GET_DATATABLE: Das Scriptergebnis wird versucht in einer Tabelle darzustellen.
  • SHOW_MESSAGE: Das Scriptergebnis wird als Dialog ausgegeben.
  • SHOW_SELECTABLE_MESSAGE: Das Scriptergebnis wird als Dialog ausgegeben. Der Textinhalt ist dabei aber selektierbar.

Bei der Verwendung einer Funktion sind folgende Parameter mit anzugeben.

  • -Type=Local oder Remote

  • -Script=ScriptName.ps1

Außerdem können alle weiteren Parameter angegeben werden, die vom jeweiligen Skript erwartet werden.

Die auszuführenden Skripte sind im WebService-Verzeichnis unter PS1\{Domäne}\Custom\Local oder Remote abzulegen.

Beispielkonfiguration

Aufruf eines spezifischen Scripts mit Darstellung eines Dialogs

Das auszuführende Script liegt im Verzeichnis: {Installationspfad}\SCCM2012WebService\PS1\{Domäne}\Custom\Remote\Test.ps1

  • Assembly: PowerShellPlugin
  • Name: Mein Testskript
  • Icon: Dummy.png
  • Argument: {COMPUTERNAME}
  • SelectedComputer: SingleWithPing
  • Function: SHOW_MESSAGE
  • Parameter: -Type=Remote -Script=Test.ps1 -BeliebigerZusatzparameter=Test

Weitere Beispielkonfigurationen sind zu finden unter PowerShell API.