Getting Started
This repository contains an installer for a PowerShell module located here: Setup.
The module consists of a PowerShell module file with the extension .psm1 that is installed to %Program Files%)\SharePointProvisioning\IQAppProvisioningModule and a set of .NET assemblies that are installed to %Program Files%\SharePointProvisioning\IQAppProvisioningModule\Assemblies. When you run the installer, it will add the module to your PowerShell modules so that the module will load automatically when you launch PowerShell or PowerShell ISE.
To verify your installation, open PowerShell or PowerShell ISE, and see if you can execute the New-IQAppManifest cmdlet.
If the New-IQAppManifest cmdlet is not available, it is likely that you need to set PowerShell's execution policy to allow the module to load. To set the execution policy enter Set-ExecutionPolicy RemoteSigned and click Yes when prompted. Then close and reopen PowerShell to verify that the module is available.
There are three sample packages provided. These demonstrate the features of the engine and can help you explore the PowerShell module's cmdlets.
To use these you will need access to a SharePoint 2013, SharePoint Online, or SharePoint 2016 site in which you are the owner. It is recommended that you create a new Team site for each sample you want to deploy.
Download the package(s) of your choice and extract the files. Then open PowerShell and enter the following.
Note: Include the -Online switch if you are using SharePoint Online
$man = New-IQAppManifest -JSONFilePath "[PathToTheSamplePackageFolder]\manifest.json"
$user = "[USERNAME]"
$password = "[PASSWORD]"
$target = "[URL_TO_YOUR_SITE]"
$ctx = New-SPClientContext -SiteURL $target -UserName $user -Password $password [-Online]
Install-IQAppManifest -ClientContext $ctx -Web $ctx.Web -AppManifest $man -VerboseNotify
As the Install-IQAppManifest runs, you will see detailed output that tells you what is happening. When it finishes, open your site and have a look!
- Create a manifest from the Absence and Vacation Request Manager Site
- Create a manifest from the Angular and Bootstrap Parts Site
- Create a manifest from the Board of Directors Site