Administrator App User Manual
Contents
1. in the UI Cmdlets A single PowerShell command Cmdlets may return NET framework objects CSV Character Separated Values file format Dashboard Button Defines the selected object action credentials target or script as a filter for all stored reports The dashboard will open and show all reports connected with the selected object in a chart Edit A click on the Edit button opens a wizard to edit the properties of the selected object action credentials target or script Filter Allows filtering the current entries of a view actions targets credentials or scripts for a specific substring The filter will be applied to the name of the entries as well as other important properties like tags Wildcard characters or regular expression syntax are not supported Help Button Click the help button to get context sensitive help content IE Internet Explorer NEW A click on NEW will open a wizard to create a new action target or credential object in ScriptRunner Seite 9 ScriptRunner Administrator App User Manual Gs AppSphere Term Description Report Button Defines the selected object action credentials target or script as a filter for all stored reports The report window will open and list all reports connected with the selected object The report window will always show the last and previous report side by side You can copy the report on the right to the clipboar2. items with the respective tag EJ scripts For optimized viewing at low screen resolutions you can collapse Credentials the main navigation using the button in the top left corner of the DI Authorization top bar Figure 2 Main Navigation 1 3 NEW Clicking NEW at the bottom in the left corner starts a wizard that you can use for creating new actions target systems and credentials The available wizards do not depend on the current view A quick help is available at the top of each wizard page It can be expanded or collapsed by clicking G5 the Info hyperlink Seite 4 ScriptRunner Administrator App User Manual AppSphere 1 4 Action Bar fan A dark gray bar located at the bottom of the window provides access to permanently available as well as context dependent program functions Functions that are not available in the current user context are grayed out o Ail K ell d DI U Run Dashboard Report Copy Edit Delete Authorize Figure 3 Action bar Some functions are available in every view gt Edit and Delete Open a wizard to edit the configuration of the selected entry or delete the selected entry gt Dashboard The selected item is applied as a filter in the interactive dashboard The dashboard will then be displayed gt Report A click on Report will open the report window and the two most recent reports will be displayed side by side You can navigate through the reports depending on the current filter sel
3. no longer correct PS Remoting is not enabled on the target system The selected authentication mode is not supported by the target system Try again with a different authentication mode gt Ifyou use SSL make sure a respective certificate exists on the target system and that the root certificate is installed in the trusted root certificate store on the ScriptRunner system The ASR parameters are not shown correctly in the action wizard or the values do not arrive correctly in the script If no parameter block is defined in the script header you can also declare script parameters using the following Parameter syntax ASR Parameter Parameter Description Description 1 ASR Parameter Parameter n Description Description n Specify the parameter name without and without any space characters ScriptRunner will reflect any changes of the parameter declaration in the script after its next restart A restart is not required for changes in the script code PowerShell rules for parameter values apply There are scripts missing or there are no scripts at all in ScriptRunner Make sure that the script files are contained in the ScriptRunner script repository path By default it is ProgramData AppSphere ScriptMgr In ScriptRunner you can view and change the path in Settings The wizard to create a new object credentials target and action does not show the OK button Make sure all req
4. 0 25 20 aalala d Walk 2014 04 13 2014 04 20 2014 04 27 2014 05 04 2014 05 11 2014 05 201 2014 06 08 2014 06 15 2014 06 22 2014 06 20 2014 07 08 2014 07 13 Figure 1 ScriptRunner Dashboard Let s start with a brief overview of the dashboard Seite 3 ScriptRunner Administrator App User Manual Gs AppSphere 1 1 Dashboard After starting ScriptRunner the interactive dashboard provides access to all functions The dashboard screen includes four panels which provide access to the same categories as the main navigation section a bar chart and the context dependent action bar at the bottom Categories include Actions Targets Scripts and Credentials Each panel shows the number of entries in the respective category Clicking the panel changes to the respective category Using the filter area at the bottom of a category panel allows configuring and enabling or disabling a context dependent filter for the dashboard view You can also combine multiple filters 12 Main and Sub Navigation ScriptRunner On the left hand side is the main navigation section that navigates to the Dashboard Actions Targets Scripts and Credentials views If team functions are active there is also an Dashboard Authorization entry for the roles and their permissions gt Actions Clicking the arrow Icon next ie a navigation tem will open tag Tele controlled subsection Selecting a sub navigation item will filter the list to show only
5. 63 ScriptRunner Administrator App User Manual AppSphere AG Ottostra e 1 76275 Ettlingen Germany ScriptRunner Administrator App User Manual 3 AppSphere Contents 1 The ScriptRunner Administrator App e 1 1 Dashboard eet T 12 ain and SubsNavigatiOn EES 4 Dx ee EEE EEE EEE REEL NEE RER 4 E E ee 5 41 4 2 43 44 4 5 Troubleshooting E 8 ee 9 beier 11 e EE Ti Ee er Ti 4 24 M c Ti 4 22 EMS UO Ti Conventions ae 12 zer naleshansiss 12 Reproduction arid Wartahy 5 tie aee aa e sea HERI HOO UR IRURE iR Een RH obe s urgere Ferte itte 12 Seite 2 ScriptRunner Administrator App User Manual Gs AppSphere 1 The ScriptRunner Administrator App This document describes the main elements of the main ScriptRunner user interface the Administrator App The main elements of the user interface are the main navigation section with a sub navigation A NEW in the bottom left corner B the context dependent action bar at the bottom C the top bar menu D and the main area showing several list views or the dashboard E P Scriptk Dashboard Dashboard D 9 D Actions ACTIO TARGETS SCRIPTS Targets E Scripts D Credentials lt TueApr082014 Daiy wi ThuJul172014 gt eo 55 so 45 40 35 3
6. Qs section and a forum providing information on using ScriptRunner as well as many useful tips and tricks In addition you can register for online support create a ticket or send an e mail message to our support using your default e mail client Internal Support Specify your internal support connections here to use for your Operator role users in the ScriptRunner Delegate App for internal support messages Resources The resources section contains useful external links to valuable information on scripting and on setting up and using the Remote PowerShell Video tutorials The ScriptRunner YouTube channel shows you video tutorials about ScriptRunner License Provides license information and also allows activation of licenses Tags Tags allow identifying managing and filtering actions target systems scripts and credentials Tag management shows you all existing tags you can create new tags and change or delete existing tags ScriptRunner will automatically generate tags from the subfolders you use in the script repository and will apply these tags to the respective scripts and their actions as an initial default Settings Allows configuring of the path to the scripts repository About ScriptRunner Here you find your current ScriptRunner version number and additional information about AppSphere Seite 6 ScriptRunner Administrator App User Manual Gs AppSphere 1 6 List Views Each item of the main navigation section shows a re
7. d store it to a file or send by email Script Use actions to execute a script on one or several target systems ScriptRunner supports direct local execution and remote execution of PowerShell scripts and Visual Basic scripts Status bar The status bar shows the currently executed scripts and current messages Tag Filter Allows filtering the current entries of a view actions targets credentials or scripts for specific tags The tag filter will only show entries that have all the specified tags assigned VBS Visual Basic Script Target Target systems are physical computers or virtual machines like servers or clients in your computer network infrastructure or Cloud Services like Office365 Azure and Amazon Targets need not be part of one s own Windows domain Seite 10 ScriptRunner Administrator App User Manual Gs AppSphere 4 About this Document 4 1 Prerequisites This manual requires specific technical knowledge and that the reader is familiar with the relevant terminology In case you have not been able to solve a problem using the information provided here visit our website support appsphere com for details on how to solve specific issues 4 2 Technical Support ScriptRunner is made by AppSphere AG Technical support is provided on the AppSphere support website or by e mail Furthermore we provide some video tutorials on our YouTube channel as well as help pages and info text in the Scri
8. ection The following actions are available with the report displayed on the right side of the report window e Copy to the clipboard e Store to a file e Send by e mail Help Click Help to open context sensitive help content in the help window Status field Shows current notifications and activities during the execution of actions 1 4 1 Access context specific help contents from the Action Bar From every list view you can open specific help content by clicking on the Help button on the right hand side of the Action Bar The help window opens and shows a page with detailed information about the current view On the help page there is a help navigation bar where you can directly go to the other help pages Additional details about using ScriptRunner can be found on our support pages and in o information text elements in every modal dialog window of the configuration wizards Seite 5 ScriptRunner Administrator App User Manual Gs AppSphere 15 Top Bar The blue top bar contains controls for general commands such as Community Recommendations and Settings gear icon The current Windows user account is displayed in the top right window corner For optimized viewing at low screen resolutions you can collapse the main navigation section using the button in the top left corner of the top bar Clicking the Settings symbol D opens a menu providing access to the following options gt Support Our support page has a technical FA
9. l product descriptions are of general and descriptive nature only they do not stipulate any specific features nor do they represent any form of warranty This documentation is provided as is without warranty of any kind neither expressed nor implied AppSphere AG assumes no expressed or implied liability whatsoever for the supplied sample scripts the configured sample actions and this document All rights reserved AppSphere AG February 2015 Seite 12
10. ptRunner application itself 4 2 1 Website The ScriptRunner website offers a general overview gt www scriptrunner de The AppSphere support website at support appsphere com offers plenty of technical information Detailed manuals FAQs on ScriptRunner A customer forum where you can ask questions or obtain advice on ScriptRunner Alternatively you may send requests directly via a contact form in ScriptRunner V M M WM 4 2 2 E Mail To access technical support by e mail contact us at support appsphere com Seite 11 ScriptRunner Administrator App User Manual G AppSphere 4 3 Conventions The following formats are used for various types of instructions Bold Menus and menu items dialog names input and list boxes messages and prompts Italics Administrator entries Monospace font Code paths and filenames Hyperlinks Hyperlinks 4 4 Legal Notes AppSphere AG Ottostra e 1 76275 Ettlingen Germany Website www appsphere com 4 5 Reproduction and Warranty All information concepts and ideas laid out in this document are the property of the AppSphere AG No part of this document may be reproduced or transmitted in any form or by any means for any purpose without the express written permission of AppSphere AG Failing to do so will give rise to criminal prosecution All trademarks and product names used in this document are the properties of their respective owners and are acknowledged Al
11. spective view in the main content of the UI the dashboard view and a list view for each of the categories Actions Targets Scripts and Credentials If team functions are active there is also an Authorization list view for the configured roles and their permissions Each of the views fills the action bar with the functions that are available for the respective elements Each list view includes a tag filter and a search field Figure 4 You can use these filters separately or in combination When using the tag filter and the search function at the same time logical conjunction AND is applied for filtering Using the main navigation section items will reset all filters and search input All More filter tags Name Target Remoting credentials Parameters Date executed Recently Status Figure 4 List view of the action category Seite 7 ScriptRunner Administrator App User Manual 2 Troubleshooting Gs AppSphere Issue Solution PowerShell Remoting can t connect to a target system gt Check if the name of the target configuration in ScriptRunner is correct and if the system can be reached in your network with ping lt name gt gt The user credentials do not have sufficient rights to access the target system gt The credentials configured in ScriptRunner contain a wrong password gt The credentials configured in ScriptRunner do not exist in Active Directory gt The credentials in Windows Credential Manager are
12. uired input has been specified Multi page wizards display pages with completed input in green Required fields are marked with an exclamation mark on the right side Seite 8 ScriptRunner Administrator App User Manual 3 Glossary Gs AppSphere Term Description Action An action is a configurable policy for the context to execute a script Every action references a script a selection of targets and user credentials Bar Chart The execution statistics are represented as bar chart on the dashboard give Execution Statistics an overview on the executed scripts and the success of actions in a certain time period The data can be filtered with the sub menu in the left hand menu as well as by the category filters in the tiles Clicking a bar directly opens the report window to show the respective reports Adjust the time period displayed by setting it in the chart headline gt Single Show every action execution matching the filters gt Hourly Show the action execution matching the filters cumulated over an hour gt Daily Show the action execution matching the filters cumulated over a day Credentials User credentials are required to execute an action User credentials allow to execute a script in a different user context The user credentials are stored in the local Windows Credential Manager with prefix ASR ScriptRunner will reference these entries but will not read the entries to show the passwords
Download Pdf Manuals
Related Search