Installing and Running Windows PowerShell

Installation Requirements

Before you install Windows PowerShell, be sure that your system has the software programs that Windows PowerShell requires. Windows PowerShell requires the following programs:

· Windows XP Service Pack 2, Windows 2003 Service Pack 1, or later versions of Windows

· Microsoft .NET Framework 2.0

If any version of Windows PowerShell is already installed on the computer, use Add or Remove Programs in Control Panel to uninstall it before installing a new version.

Installing Windows PowerShell

To install Windows PowerShell:

1. Download the Windows PowerShell installation file. (The name of the file will differ with the platform, operating system, and language pack.)

2. To start the installation, click Open.

3. Follow the instructions on the installation wizard pages.

You can also save the Windows PowerShell files to a network share for installation on multiple computers.

To perform a silent installation, type:

<PowerShell-exe-file-name> /quiet

For example,

PowerShellSetup_x86_fre.exe /quiet

On 32-bit versions of Windows, Windows PowerShell is installed, by default, in the %SystemRoot%\System32\WindowsPowerShell\v1.0  directory. On 64-bit versions of Windows, a 32-bit version of Windows PowerShell is installed in the %SystemRoot%\SystemWow64\WindowsPowerShell\v1.0 directory and a 64-bit version of Windows PowerShell is installed in the %SystemRoot%\System32\WindowsPowerShell\v1.0 directory.

Running Windows PowerShell

To start Windows PowerShell from the Start Menu, click Start, click All Programs, click Windows PowerShell 1.0, and then click the Windows PowerShell icon.

To start Windows PowerShell from the Run box, click Start, click Run, type powershell, and click OK.

To start Windows PowerShell from a Command Prompt (cmd.exe) window, at the command prompt, type powershell. Because Windows PowerShell runs in a console session, you can use this same technique to run it within a remote telnet or SSH session. To return to your Command Prompt session, type exit.

How to install an additional cache server and join it to the cache cluster

Confirm hardware and software requirements and install pre-requisites on the cache server. For more information, see the "Velocity" download page.

Download the "Velocity" installation program from the "Velocity" download page and copy it to the cache server. There are two installation programs available:

MicrosoftDistributedCache-i386.exe: Use this program to install "Velocity" on 32-bit computers.

MicrosoftDistributedCache-amd64.exe: Use this program to install "Velocity" on x64-based computers.

Perform the cache server installation using the setting of the cache cluster you want the cache server to join. This can be done manually with the graphical user interface (GUI) or by using command-line parameters to automate a "silent" installation. For more information about a cache server installation, see Cache Server Installation (Velocity).

GUI installation: To begin the GUI installation, double-click on the installation program.

Automated installation: To perform an automated installation, open the CMD.exe command-line tool and navigate to the folder within which you saved the installation program. Then, execute the installation program using the automation parameters. For more information, see Automated Cache Server Installation (Velocity).

Open the PowerShell-based cache administration tool from the shortcut that was installed on the desktop of the cache server. Note: On Microsoft Windows Vista and Microsoft Windows Server 2008 operating systems, you will have to right-click the "Velocity" PowerShell shortcut and select Run as administrator for the cache administration tool to work correctly.

Set the PowerShell execution policy for signed assemblies, this is required to run the cache administration cmdlets. Depending on how your cache server is configured, you may not be prompted to set the policy. Follow the prompt or set the policy manually using the command: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Join the cache server to the cache cluster using the Start-CacheHost command. For example, if you performed the cache server installation on a computer named CacheServer1 with the default values for the TCP/IP port numbers, you would use the following command to start the server's cache host service: Start-CacheHost -HostName CacheServer1 -CachePort 22233. For more information about the cache administration commands available, see Cache Administration with PowerShell (Velocity).