Getting Started

Installation

All SAPIEN Technologies software products are downloadable only. Once a customer registers or updates a product on my.sapien.com, the download screen appears. The installer software is saved as SPS15Setup_xxx.exe to your default download folder. Upon execution, the installation wizard first checks several items such as available disk space and existence of previous builds. If the environment is adequate, the installer will display the legal agreement which you must accept in order to proceed. At any point in the process, you may click "Next" to move to the next stage or "Back" to return to a previous screen.

There are three types of installation:

• Typical
  Recommended for most users, it will install PowerShell Studio 2015, the component library, ScriptMerge 2015, the MS Chart Controls, the SAPIEN Document Explorer, and both the 32- and 64-bit versions of Visual C++.
• Custom
  This option allows you to select which features to install. This option is recommended only for advanced users since portions of PowerShell Studio may not be available if you do not select the appropriate components at this point.
• Complete
  This option will install all components, namely, PowerShell Studio 2015, the component library, ScriptMerge 2015, the MS Chart Controls, the SAPIEN Document Explorer, and both the 32- and 64-bit versions of Visual C++.

Installing Powershell Studio 2015

1. Double-click on the program exe and the splash screen comes up. Click Next.
   
2. Accept the terms of the license agreement in order to continue. You should never accept license terms unless you have read and understand them. Once you've accepted the terms, click Next.
   
3. Enter your user information and click Next.
   
4. Choose the installation type and click Next.
   
5. Choose whether you want to optimize the application startup and click Install followed by Finish.
   

Firewall Considerations

PowerShell Studio can install a small service to support the Remote Script Execution Engine. This will result in a firewall warning as the service attempts to open the port it listens on. For more information, consult the chapter on the Remote Script Execution Engine feature.

PowerShell Studio occasionally attempts to access a text file located on the sapien.com web site. This text file contains the version number of the current version of PowerShell Studio; your firewall software may warn you when PowerShell Studio attempts to read this file for the first time. PowerShell Studio does not transmit any personally-identifiable information when making this check-its sole purpose is to notify you when updates are available.

PowerShell Studio also accesses the Web to display its product registration page (after initial installation), and to display Web pages when you click on links in the Info Browser.

Registering Your Product

You should have registered your copy of PowerShell Studio 2015 before downloading it, but if you didn't, be sure to register it once it is up and running.

To do so:

1. Press the Register Product button located in the Help tab of the ribbon.
   
2. Your default Web browser will open to the registration page.
   

Registration is required in order activate and operate the product. In addition, it is required to obtain any customer service or technical support benefits, and it takes only a few moments to complete. Registration also provides you with access to special offers including preferred pricing on renewals.

Removing Your License

Need to remove your PowerShell Studio 2015 license so that you can use it on another computer?

1. Click on the License Information in the top right of the PowerShell Studio window.
   
2. Click Deactivate License.
   

-OR-

1. Click on the About Icon in the top right of the PowerShell Studio window.
   
2. Select your PowerShell Studio license from the list of SAPIEN product licenses
   
3. Click Deactivate License
   

PowerShell Studio 2015 will immediately become a trial version and your license key will be available for use on another computer.

Troubleshooting & Command-Line Switches

PowerShell Studio supports one command line switch: /NOSPLASH. This switch is case sensitive and it will suppress the splash screen that normally appears when PowerShell Studio is started.

Caching PowerShell Commands

When PowerShell Studio starts up it scans your machine looking for PowerShell modules, snapins, aliases and help files. These are added to the PowerShell Browser window where they can be added to your scripts simply by double clicking on the required item or right-clicking and selecting Insert. The item is inserted at the current location of the cursor.

You can rebuild the cache by clicking on the refresh button located in the top right of the Object Browser window.