• Blog
  • Webinars
  • Partner
  • Support
  • Contact
ScriptRunner
  • About us
    • Team
    • Jobs
    • Press
  • Why
  • Use Cases
  • Software
    • ScriptRunner Server
    • ScriptRunner Web Apps
    • ScriptRunner Connectors
    • ScriptRunner ActionPacks
  • Try Now
  • Search
  • Menu Menu
You are here: Home1 / ScriptRunner Blog2 / Scripting3 / Global Settings with the ScriptRunnerSettings PowerShell Module

Global Settings with the ScriptRunnerSettings PowerShell Module

Author: Frank Kresse, Head of Product | Reading time: 2 minutes | Category: Scripting

Global Settings with the ScriptRunnerSettings PowerShell Module

This article has been translated automatically.

The global configuration of the ScriptRunner Service Host was previously done via various settings in Setup, Admin App, LicenseViewer and manual settings on the system.

Apart from the distribution to different areas of ScriptRunner this had the disadvantage that every admin could make global settings with the Admin App and change them for all other users.

For this reason, all system-relevant global settings have been centralized in the PowerShell ScriptRunnerSettings module. The user of the module must have appropriate access and system rights for the operating system on the ScriptRunner Service Host. These rights are now independent of the membership in the role ScriptRunner Administrators.

The module maps the following functional areas for global settings:

  • licensing
  • Connections for license activation via Internet proxy
  • Script Library Directory and Archive Function
  • directly usable PowerShell modules
  • SQL connection string to external reporting/auditing database
  • ScriptRunner Service

Important common cmdlets to view the configuration of the ScriptRunner Service Host.

Get-ASRSettings: shows the most important settings of the ScriptRunner host.

Get-ASRService: displays the status of the service on the ScriptRunner host.

Get-ASRLicense: reads the currently valid license information from the license file. This information can also be viewed via the Admin App under Settings.

The licensing functions are mapped with the following cmdlet:

Initialize-ASRLicense: is required once for the initial registration of a license. The license key must be a serial number key. For an offline license, a second offline enabling key is required, which was generated specifically for the customer’s machine ID4.

During initialization, the company name and contact must also be entered in addition to the keys.

Update-ASRLicense: is used for all further license registrations, e.g. for the keys of connector licenses, license extensions and maintenance keys.

Get-ASRLicensedUser: creates a list of all accounts automatically registered by ScriptRunner.

Disable-ASRLicensedUser: deactivates an account automatically registered by ScriptRunner that is no longer actively used; a user license becomes free.

An Internet connection is required once to activate the license. Depending on the network structure, a proxy configuration with or without login is required for the connection.

GetASRLicenseProxy: displays the proxy settings.

Set-ASRLicenseProxy: configures the proxy settings.

The central repository uses a Script Library directory on the ScriptRunner Service Host. This directory is located under LW:ProgramDataAppsphereScriptMgr by default.

Set-ASRSettings: changes the ScriptRunner Library directory, e.g. when using a checked out directory from Git, SVN, TFS or other code versioning systems.

Attention. This change affects the functionality of all already configured actions !

With Set-ASRSettings the archive function for the Check-Out/Check-In function of the ISE App can also be switched on or off.

With ScriptRunner policies (actions) both script and cmdlets can be executed directly instead of a script in a controlled way. If CmdLets are to be made available for direct use in actions instead of scripts, the cmdlets from the modules must be made accessible in ScriptRunner.

Get-ASRPSModule: lists all PowerShell modules directly usable in ScriptRunner for actions.

Add-ASRPSModule: adds PowerShell modules to ScriptRunner for direct use in actions.

Remove-ASRPSModule: removes PowerShell modules for direct use in actions

ScriptRunner supports parallel writing of PowerShell reports including the corresponding metadata into an external SQL database. Connection settings are made using cmdlets. A valid SQL Connector license is required.

Get-ASRSQLConnect: displays the configured SQL connection string.

Set-ASRSQLConnect: configures the SQL Connection String. Explicit and implicit logon can be used. To this an administrative account can be assigned to the SQL Audit/Report Connector in the Admin App, which must have the rights to write in the database.

The ScriptRunner service on the host must be restarted if some global settings are changed. In addition, the service can be switched off for maintenance work.

Restart ASRService: Restarts the service on the ScriptRunner host. Cmdlet functions that require a restart after changing the settings also have this function as an integrated parameter function.

Stop-ASRService: Stops the service on the ScriptRunner host.

Start-ASRService: Starts the service on the ScriptRunner host.

Support in case of problems

If you should expect or have problems with the update, please contact our Website support.scriptrunner.com  or support@scriptrunner.com. We will be glad to help you.

Beitrag teilen
  • Share on Facebook
  • Share on Twitter
  • Share on LinkedIn
  • Share on Reddit
  • Share by Mail

These posts might also be interesting for you:

Article: X-mas Fun with PowerShell and ScriptRunnerScriptRunner Software GmbH

X-mas Fun with PowerShell and ScriptRunner

23. December 2020
Read more
https://www.scriptrunner.com/wp-content/uploads/2020/12/xmas-fun-powershell.jpg 1000 1000 Bruno Buyck https://www.scriptrunner.com/wp-content/uploads/2018/05/ScriptRunner_Logo_RGB-300x45.png Bruno Buyck2020-12-23 10:00:412021-01-07 16:26:55X-mas Fun with PowerShell and ScriptRunner
Article image: PowerShell AliasingScriptRunner Software GmbH

PowerShell Aliasing

2. December 2020
Read more
https://www.scriptrunner.com/wp-content/uploads/2020/11/powershell-aliasing.png 1000 1000 Marco Kamner https://www.scriptrunner.com/wp-content/uploads/2018/05/ScriptRunner_Logo_RGB-300x45.png Marco Kamner2020-12-02 10:00:072021-01-07 16:33:54PowerShell Aliasing
PowerShell Advanced Functions - Sunny JamwalScriptRunner Software GmbH

PowerShell Advanced Functions

21. October 2020
Read more
https://www.scriptrunner.com/wp-content/uploads/2020/10/Advanced-posh-functions-1.jpg 500 500 Sunny Jamwal https://www.scriptrunner.com/wp-content/uploads/2018/05/ScriptRunner_Logo_RGB-300x45.png Sunny Jamwal2020-10-21 10:00:032021-01-07 16:59:39PowerShell Advanced Functions

About the author:

Frank Kresse, Head of Product

Frank Kresse is the Head of Product. As the inventor of the automation and delegation solution for PowerShell, he advises clients on use case scenarios and develops solutions for the automation and the digitalization of their processes. He is also involved in technology start-ups.

Latest posts:

  • Article: X-mas Fun with PowerShell and ScriptRunnerScriptRunner Software GmbHX-mas Fun with PowerShell and ScriptRunner23. December 2020 - 10:00
  • ScriptRunner Software GmbHUsing PowerShell to Create New Citrix MCS Machines15. December 2020 - 16:25
  • Article: An Introduction to PowerShell in Citrix Virtual Apps and DesktopsScriptRunner Software GmbHAn Introduction to PowerShell in Citrix Virtual Apps and Desktops7. December 2020 - 17:01
  • Article image: PowerShell AliasingScriptRunner Software GmbHPowerShell Aliasing2. December 2020 - 10:00
  • Article image: ScriptRunner sponsors Scottish Summit 2021ScriptRunner Software GmbHScriptRunner sponsors the Scottish Summit 202125. November 2020 - 10:00

Product

  • ScriptRunner Platform
  • ScriptRunner Server
  • ScriptRunner Apps
  • ScriptRunner Connectors
  • Script Collections
  • Licensing
Get your free trial

Solutions

  • IT Administrators
  • IT Team Leaders
  • Use Cases

Resources

  • Blog
  • Documentation
  • Knowledge Base
  • Webinars
  • PowerShell Lexicon
  • PowerShell Poster
  • PowerShell Security Ebook

Company

  • About us
  • Team
  • Jobs
  • Press
  • References
  • Partner

Contact

ScriptRunner Software GmbH
Ludwig-Erhard-Straße 2
76275 Ettlingen
Germany

T: +49 7243 20715-0
M: info(at)scriptrunner.com

Request Demo
© ScriptRunner Software GmbH is a subsidiary of AppSphere AG
  • LinkedIn
  • Xing
  • Twitter
  • Facebook
  • Youtube
  • Imprint
  • Privacy Policy
  • Newsletter
Long-term storage and auditing of PowerShell Reports Bulk Actions with PowerShell and ScriptRunner Bulk Actions Made Easy with PowerShell and ScriptRunner
Scroll to top