Installation and Troubleshooting

• Requirements
• Installation
• Troubleshooting FAQ:

Requirements

The installation of the Cmdlets4Sas depends on two components on your Windows machine:

1. Microsoft PowerShell
   Supported Versions:

   • PowerShell 4.0 (http://www.microsoft.com/en-us/download/details.aspx?id=40855)
     PowerShell 4.0 is supported on Windows 7 SP1, Windows 8.1, Windows Server 2008 R2 SP1 and Windows Server 2012.
   • PowerShell 3.0 (http://www.microsoft.com/en-us/download/details.aspx?id=34595)
     PowerShell 3.0 itself is supported on Windows 7 SP1, Windows Server 2008 SP2 and Windows Server 2008 R2 SP1 and depends on the Microsoft .Net Framework 4 (http://www.microsoft.com/en-us/download/details.aspx?id=17851).
   • PowerShell 2.0 (http://support.microsoft.com/kb/968929)
     This PowerShell Runtime is supported in older Windows versions (Windows XP SP3, Windows Vista and Windows Server 2003).

   You should always prefer the PowerShell 3.0 or 4.0 runtime unless you run on the mentioned old operating systems!

2. SAS IT Client.
   Supported Versions:

   • IT Client 9.4 (http://support.sas.com/demosdownloads/sysdep_t1.jsp?packageID=1263)
     This software package is already installed on your machine if any SAS 9.4 Client has been installed. If it is not already installed you can download a free copy from the SAS homepage
   • IT Client 9.3
     This software package is already installed on your machine if any SAS 9.3 Client has been installed. If it is not already installed you can download a free copy from the SAS homepage (http://support.sas.com/demosdownloads/sysdep_t1.jsp?packageID=1035).

   Some of the functionality of the commandlets may also work with older versions of the SAS IT Client, but for the full support you should use the 9.3 version or above.

3. SAS Providers for OLE DB
   If you plan to access SAS datasets e.g. with the Read-SasData cmdlet then the free SAS database drivers have to be installed. This software package is already installed on your machine if any SAS Client has been installed. If it is not already installed you can download a free copy from the SAS homepage
   http://support.sas.com/downloads/browse.htm?fil=1&cat=64

Installation

The installation consists of two easy steps:
1) simple drop in deployment: copy the files to one of the powershell plugin folders
2) load the commandlets as a plugin in your powershell session by calling Import-Module cmdlets4sas
For details see file InstallationInstructions.txt

Troubleshooting FAQ:

Q: I want to install PowerShell, but i don't know which file i need to download
A: The file names Microsoft has chosen are technical names. So Windows 7 is refered to as "Windows6.1". To make sure that you download and install the correct version carefully read the "Install Instructions" section on the download page!

Q: I want to execute a Powershell script, but i get the error "File ... cannot be loaded because running scripts is disabled on this system."
A: By default Powershell does not allow the execution of scripts on your PC. This security setting should prevent inexperienced Windowsusers from executing malicious scripts which could damage your system.
To activate the execution of Powershell scripts you can start a new Powershell session as an administrator and execute the command
Set-ExecutionPolicy RemoteSigned
and confirm the question if you really want to change the settings.
As an alternative you can execute the SetExecutionPolicy.bat file included in the Cmdlets4Sas ZIP file with administrator privileges.
For more information about the execution policies of powershell please refer to these links:
http://blogs.sas.com/content/sasdummy/2011/09/12/running-windows-powershell-scripts/
http://technet.microsoft.com/en-us/library/ee176949.aspx

Q: I want to execute a Powershell script, but i get the error "Import-Module : The required module 'Cmdlets4SasScripts' is not loaded. Load the module or remove the module from 'RequiredModules' "
A: This was a bug in version 1.0 which only existed in the PowerShell 2.0 runtime. It was fixed in version 1.1.