Globale Einstellungen mit dem ScriptRunnerSettings-PowerShell-Modul

Die globalen Einstellungen des ScriptRunner Service Hosts erfolgten bisher über verschiedene Einstellungen im Setup, Admin App, LicenseViewer und manuelle Einstellungen am System.

Post Featured Image

Neben der Verteilung auf verschiedene Bereiche von ScriptRunner hatte dies den Nachteil, dass jeder Admin mit der Admin App globale Einstellungen vornehmen und für alle anderen Benutzer ändern konnte.

Aus diesem Grund wurden alle systemrelevanten globalen Einstellungen im PowerShell-Modul ScriptRunnerSettings zentralisiert. Der Anwender des Moduls muss über entsprechende Zugriffs- und Systemrechte für das Betriebssystem auf dem ScriptRunner Service Host verfügen. Diese Rechte sind nun unabhängig von der Mitgliedschaft in der Rolle ScriptRunner-Administratoren.

Das Modul bildet die folgenden Funktionsbereiche für globale Einstellungen ab:

  • Lizenzierung
  • Verbindungen zur Lizenzaktivierung über Internet-Proxy
  • Script Library Directory und  Archiv-Function
  • direkt verwendbare PowerShell-Module
  • SQL-Verbindungsstring zur externen Report-/Audit-Datenbank
  • ScriptRunner Service

Wichtige allgemeine Cmdlets zum Anzeigen der Konfiguration des ScriptRunner-Service-Hosts.

  • Get-ASRSettings: zeigt die wichtigsten Einstellungen des ScriptRunner-Hosts.1-4
  • Get-ASRService: zeigt den Status des Dienstes auf dem ScriptRunner-Host an.
  • Get-ASRLicense: liest die aktuell gültigen Lizenzinformationen aus der Lizenzdatei. Diese Informationen können auch über die Admin App unter Einstellungen eingesehen werden.

Screenshot_License_status_english-1

4-1-1

Die Lizenzierungsfunktionen werden mit dem folgenden Cmdlet abgebildet:

  • Initialize-ASRLicense: ist einmalig für die Erstregistrierung einer Lizenz erforderlich. Der Lizenzschlüssel muss ein Seriennummernschlüssel sein. Für eine Offline-Lizenz ist ein zweiter Offline-Freischaltschlüssel erforderlich, der speziell für die Maschinen-ID4 des Kunden erzeugt wurde.
    Bei der Initialisierung müssen neben den Tasten auch der Firmenname und der Kontakt eingegeben werden.
  • Update-ASRLicense: wird für alle weiteren Lizenzregistrierungen verwendet, z. B. für die Schlüssel von Konnektorlizenzen, Lizenzerweiterungen und Wartungsschlüssel.
  • Get-ASRLicensedUser: erstellt eine Liste aller von ScriptRunner automatisch registrierten Konten.
  • Disable-ASRLicensedUser: deaktiviert ein von ScriptRunner automatisch registriertes Konto, das nicht mehr aktiv genutzt wird; eine Benutzerlizenz wird frei.
    Zur Aktivierung der Lizenz wird einmalig eine Internetverbindung benötigt. Je nach Netzwerkstruktur ist für die Verbindung eine Proxy-Konfiguration mit oder ohne Anmeldung erforderlich.
  • GetASRLicenseProxy: zeigt die Proxy-Einstellungen an.
  • Set-ASRLicenseProxy: konfiguriert die Proxy-Einstellungen.
    Das zentrale Repository verwendet ein Script Library-Verzeichnis auf dem ScriptRunner Service Host. Dieses Verzeichnis befindet sich standardmäßig unter LW:\\ProgramData\Appsphere\ScriptMgr.
  • Set-ASRSettings:ändert das ScriptRunner Library-Verzeichnis, z. B. bei Verwendung eines ausgecheckten Verzeichnisses aus Git, SVN, TFS oder anderen Codeversionierungssystemen.

Achtung! Diese Änderung betrifft die Funktionalität aller bereits konfigurierten Aktionen !

Mit Set-ASRSettings kann auch die Archivfunktion für die Check-Out/Check-In-Funktion der ISE-App ein- oder ausgeschaltet werden.

Mit ScriptRunner-Richtlinien (Aktionen) können sowohl Scripte als auch Cmdlets direkt anstelle eines Skripts kontrolliert ausgeführt werden. Wenn CmdLets für die direkte Verwendung in Aktionen anstelle von Scripten zur Verfügung gestellt werden sollen, müssen die Cmdlets aus den Modulen in ScriptRunner zugänglich gemacht werden.

Screenshot_Library_status_english

  • Get-ASRPSModule: listet alle PowerShell-Module auf, die direkt in ScriptRunner für Aktionen verwendet werden können.
  • Add-ASRPSModule: fügt PowerShell-Module zu ScriptRunner für die direkte Verwendung in Aktionen hinzu.
  • Remove-ASRPSModule: Entfernt PowerShell-Module für die direkte Verwendung in Aktionen

ScriptRunner unterstützt das parallele Schreiben von PowerShell-Berichten einschließlich der zugehörigen Metadaten in eine externe SQL-Datenbank. Die Verbindungseinstellungen werden über Cmdlets vorgenommen. Es wird eine gültige SQL Connector-Lizenz benötigt.

  • Get-ASRSQLConnect: zeigt den konfigurierten SQL-Verbindungsstring an.
  • Set-ASRSQLConnect: konfiguriert den SQL-Verbindungsstring. Es können explizite und implizite Anmeldungen verwendet werden. Dazu kann dem SQL Audit/Report Connector in der Admin App ein administratives Konto zugewiesen werden, das die Rechte zum Schreiben in der Datenbank haben muss.

8-1-1

Der ScriptRunner-Dienst auf dem Host muss neu gestartet werden, wenn einige globale Einstellungen geändert werden. Darüber hinaus kann der Dienst für Wartungsarbeiten abgeschaltet werden.

  • Restart ASRService: Startet den Dienst auf dem ScriptRunner-Host neu. Cmdlet-Funktionen, die nach dem Ändern der Einstellungen einen Neustart erfordern, haben diese Funktion ebenfalls als integrierte Parameterfunktion.
  • Stop-ASRService: Stoppt den Dienst auf dem ScriptRunner-Host.
  • Start-ASRService: Startet den Dienst auf dem ScriptRunner-Host.

Unterstützung bei Problemen

Sollten Sie Probleme mit dem Update erwarten oder haben, wenden Sie sich bitte an support@scriptrunner.com. Wir helfen Ihnen gerne weiter.

Zusammenhängende Posts

10 min read

Exchange Online Quarantäne-Richtlinien

5 min read

Azure-Billings mit ScriptRunner

Über den Autor: