Installation Scripts¶

Overview¶

Vinyl ships with several PowerShell scripts which aid in deployment and configuration.

Scripts Directory¶

The PowerShell scripts are located in the \Scripts directory, beneath the Vinyl installation directory. For example, assuming Vinyl has been installed in the following directory:

C:\inetpub\wwwroot\Vinyl

The PowerShell scripts can be found in the following directory:

C:\inetpub\wwwroot\Vinyl\Scripts

Scripts¶

Vinyl ships with the following PowerShell scripts:

• TestInstall.ps1
• GrantAppPoolPermission.ps1
• RegisterCrystalReports.ps1

Requirements¶

Execution Policy¶

The Vinyl PowerShell scripts are not signed. To execute unsigned PowerShell scripts, administrators will need to change the PowerShell execution policy. To change the PowerShell script execution policy to "RemoteSigned", for instance, execute the following PowerShell command from an elevated command prompt:

> Set-ExecutionPolicy RemoteSigned

Elevated Command Prompt¶

Because the PowerShell scripts query the IIS metabase, they need to be executed from an elevated command prompt. Attempting to execute the scripts without elevated permissions will return the following error:

Import-Module : The script 'Vinyl.psm1' cannot be run because it contains a "#requires" statement for running as Administrator. The current Windows PowerShell session is not running as Administrator. Start Windows PowerShell by using the Run as Administrator option, and then try running the script again.

Web Administration Provider for Windows PowerShell¶

Vinyl uses the Web Administration Provider for Windows PowerShell to interact with IIS. Typically, this is installed as part of the Web werver role.

Design Notes¶

Vinyl's PowerShell scripts follow PowerShell best practices, using approved verbs.