Permalink
Cannot retrieve contributors at this time
Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.
Sign up
Fetching contributors…
Cannot retrieve contributors at this time
| [CmdletBinding(SupportsShouldProcess=$true, ConfirmImpact='Medium')] | |
| [OutputType([int])] | |
| Param | |
| ( | |
| [Parameter(Mandatory=$true, Position=0)] | |
| [ValidateNotNullOrEmpty()] | |
| [string]$AppName, | |
| [Parameter(Mandatory=$true, Position=1)] | |
| [ValidateNotNullOrEmpty()] | |
| [string]$WebUrl, | |
| [Parameter(Mandatory=$true, Position=2)] | |
| [ValidateNotNullOrEmpty()] | |
| [string]$RemoteAppUrl, | |
| [Parameter(Mandatory=$true, Position=3)] | |
| [ValidateNotNullOrEmpty()] | |
| [string]$DeployUserName, | |
| [Parameter(Mandatory=$true, Position=4)] | |
| [ValidateNotNullOrEmpty()] | |
| [string]$DeployPassword | |
| ) | |
| function Install-App($clientContext, $appPackage, $productId) { | |
| $appName = [System.IO.Path]::GetFileNameWithoutExtension($appPackage) | |
| $web = $clientContext.Web | |
| Write-Verbose "Start to install app $appName..." | |
| # Try to uninstall any existing app instances first. | |
| Uninstall-App $clientContext $productId | |
| Write-Verbose "Installing app $appName..." | |
| $appInstance = $web.LoadAndInstallAppInSpecifiedLocale(([System.IO.FileInfo]$appPackage).OpenRead(), $web.Language) | |
| $clientContext.Load($appInstance) | |
| $clientContext.ExecuteQuery() | |
| $appInstance = WaitForAppOperationComplete $clientContext $appInstance.Id | |
| if (!$appInstance -Or $appInstance.Status -ne [Microsoft.SharePoint.Client.AppInstanceStatus]::Installed) | |
| { | |
| if ($appInstance -And $appInstance.Id) | |
| { | |
| Write-Error "App installation failed. To check app details, go to '$($web.Url.TrimEnd('/'))/_layouts/15/AppMonitoringDetails.aspx?AppInstanceId=$($appInstance.Id)'." | |
| } | |
| throw "App installation failed." | |
| } | |
| return $appInstance.Id | |
| } | |
| function Uninstall-App($clientContext, $productId) { | |
| $appInstances = $web.GetAppInstancesByProductId($productId) | |
| $clientContext.Load($appInstances) | |
| $clientContext.ExecuteQuery() | |
| if ($appInstances -And $appInstances.Length -gt 0) | |
| { | |
| $appInstance = $appInstances[0] | |
| Write-Verbose "Uninstalling app with instance id $($appInstance.Id)..." | |
| $appInstance.Uninstall() | out-null | |
| $clientContext.Load($appInstance) | |
| $clientContext.ExecuteQuery() | |
| $appInstance = WaitForAppOperationComplete $clientContext $appInstance.Id | |
| # Assume the app uninstallation succeeded | |
| Write-Verbose "App was uninstalled successfully." | |
| } | |
| } | |
| function WaitForAppOperationComplete($clientContext, $appInstanceId) { | |
| for ($i = 0; $i -le 2000; $i++) | |
| { | |
| try | |
| { | |
| $web = $clientContext.Web | |
| $instance = $web.GetAppInstanceById($appInstanceId) | |
| $clientContext.Load($instance) | |
| $clientContext.ExecuteQuery() | |
| } | |
| catch [Microsoft.SharePoint.Client.ServerException] | |
| { | |
| # When the uninstall finished, "app is not found" server exception will be thrown. | |
| # Assume the uninstalling operation succeeded. | |
| break | |
| } | |
| if (!$instance) | |
| { | |
| break | |
| } | |
| $result = $instance.Status; | |
| if ($result -ne [Microsoft.SharePoint.Client.AppInstanceStatus]::Installed -And | |
| !$instance.InError -And | |
| # If an app has failed to install correctly, it would return to initialized state if auto-cancel was enabled | |
| $result -ne [Microsoft.SharePoint.Client.AppInstanceStatus]::Initialized) | |
| { | |
| Write-Verbose "Instance status: $result" | |
| Start-Sleep -m 1000 | |
| } | |
| else | |
| { | |
| break | |
| } | |
| } | |
| return $instance; | |
| } | |
| function Enable-SideLoading { | |
| param($clientContext, $enable = $true, $force = $false) | |
| # this is the side-loading Feature ID.. | |
| $FeatureId = [GUID]("AE3A1339-61F5-4f8f-81A7-ABD2DA956A7D") | |
| # ..and this one is site-scoped, so using $clientContext.Site.Features.. | |
| $siteFeatures = $clientContext.Site.Features | |
| $clientContext.Load($siteFeatures) | |
| $clientContext.ExecuteQuery() | |
| $feature = $siteFeatures | Where-Object { $_.DefinitionId -eq $FeatureId } | Select-Object -First 1 | |
| if ($feature) | |
| { | |
| if ($enable) | |
| { | |
| Write-Verbose "Feature is already activated in this site." | |
| return | |
| } | |
| else | |
| { | |
| $siteFeatures.Remove($featureId, $force) | |
| } | |
| } | |
| else | |
| { | |
| if ($enable) | |
| { | |
| $siteFeatures.Add($featureId, $force, [Microsoft.SharePoint.Client.FeatureDefinitionScope]::None) | |
| } | |
| else | |
| { | |
| Write-Verbose "The feature is not active at this scope." | |
| return | |
| } | |
| } | |
| try | |
| { | |
| $clientContext.ExecuteQuery() | |
| if ($enable) | |
| { | |
| Write-Verbose "Feature '$FeatureId' successfully activated.." | |
| } | |
| else | |
| { | |
| Write-Verbose "Feature '$FeatureId' successfully deactivated.." | |
| } | |
| } | |
| catch | |
| { | |
| throw "An error occurred whilst activating/deactivating the Feature. Error detail: $($_)" | |
| } | |
| } | |
| function Load-Assemblies { | |
| # suppress output | |
| $assembly1 = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client") | |
| $assembly2 = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client.Runtime") | |
| Write-Verbose "Assemblies loaded." | |
| } | |
| function WaitFor-IEReady { | |
| [CmdletBinding()] | |
| Param | |
| ( | |
| [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)] | |
| $ie, | |
| [Parameter(Mandatory=$false, Position=1)] | |
| $initialWaitInSeconds = 1 | |
| ) | |
| sleep -Seconds $initialWaitInSeconds | |
| while ($ie.Busy) { | |
| sleep -milliseconds 50 | |
| } | |
| } | |
| <# | |
| .Synopsis | |
| Invoke a java script function. | |
| .DESCRIPTION | |
| Use this function to run JavaScript on a web page. Your $Command can | |
| return a value which will be returned by this function unless $global | |
| switch is specified in which case $Command will be executed in global | |
| scope and cannot return a value. If you received error 80020101 it means | |
| you need to fix your JavaScript code. | |
| .EXAMPLE | |
| Invoke-JavaScript -IE $ie -Command 'Post.IsSubmitReady();setTimeout(function() {Post.SubmitCreds(); }, 1000);' | |
| .EXAMPLE | |
| $result = Invoke-JavaScript -IE $ie -Command 'Post.IsSubmitReady();setTimeout(function() {Post.SubmitCreds(); }, 1000);' -Global | |
| #> | |
| function Invoke-JavaScript { | |
| [CmdletBinding()] | |
| [OutputType([string])] | |
| Param | |
| ( | |
| [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)] | |
| $IE, | |
| [Parameter(Mandatory=$true, Position=1)] | |
| $Command, | |
| [switch]$Global | |
| ) | |
| if (-not $Global.IsPresent) { | |
| $Command = "document.body.setAttribute('PSResult', (function(){ $Command })());" | |
| } | |
| $document = $IE.document | |
| $window = $document.parentWindow | |
| $window.execScript($Command, 'javascript') | Out-Null | |
| if (-not $Global.IsPresent) { | |
| return $document.body.getAttribute('PSResult') | |
| } | |
| } | |
| function Get-AppPackageInformations { | |
| [CmdletBinding()] | |
| [OutputType([Hashtable])] | |
| param([string]$Path, [string]$AppWebUrl) | |
| # Open zip | |
| Add-Type -assembly System.IO.Compression.FileSystem | |
| Write-Verbose "Open zip file '$Path'..." | |
| $zip = [System.IO.Compression.ZipFile]::Open($Path, "Update") | |
| try{ | |
| $fileToEdit = "AppManifest.xml" | |
| $file = $zip.Entries.Where({$_.name -eq $fileToEdit}) | |
| Write-Verbose "Read app manifest from '$file'." | |
| $desiredFile = [System.IO.StreamReader]($file).Open() | |
| [xml]$xml = $desiredFile.ReadToEnd() | |
| $desiredFile.Close() | |
| if ($env:ClientId){ | |
| $clientId = $env:ClientId | |
| }else{ | |
| $clientId = $xml.App.AppPrincipal.RemoteWebApplication.ClientId | |
| } | |
| $appInformations = @{ | |
| ClientId = $clientId | |
| Version = $xml.App.Version | |
| AllowAppOnlyPolicy = [bool]$xml.App.AppPermissionRequests.AllowAppOnlyPolicy | |
| Title = $xml.App.Properties.Title | |
| ProductID = $xml.App.ProductID | |
| } | |
| if ($AppWebUrl){ | |
| # Replace URL | |
| $value = $xml.App.Properties.StartPage | |
| Write-Verbose "Replace URL in '$value' with '$AppWebUrl'." | |
| $value = $value -replace "^.*\?","$($AppWebUrl)?" | |
| $xml.App.Properties.StartPage = $value | |
| if ($env:ClientId){ | |
| Write-Verbose "Found ClientId '$env:ClientId' in environment. Replace it in app." | |
| $xml.App.AppPrincipal.RemoteWebApplication.ClientId = $env:ClientId | |
| } | |
| # Save file | |
| Write-Verbose "Save manifest to '$file'." | |
| $desiredFile = [System.IO.Stream]($file).Open() | |
| $desiredFile.SetLength(0) | |
| $xml.Save($desiredFile) | |
| $desiredFile.Flush() | |
| $desiredFile.Close() | |
| $desiredFile.Dispose() | |
| $desiredFile = [System.IO.StreamReader]($file).Open() | |
| [xml]$xml = $desiredFile.ReadToEnd() | |
| Write-Host $xml | |
| $desiredFile.Close() | |
| $desiredFile.Dispose() | |
| } | |
| return $appInformations | |
| }finally{ | |
| # Write the changes and close the zip file | |
| $zip.Dispose() | |
| } | |
| } | |
| function WaitFor-IEReady { | |
| [CmdletBinding()] | |
| Param | |
| ( | |
| [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)] | |
| $ie, | |
| [Parameter(Mandatory=$false, Position=1)] | |
| $initialWaitInSeconds = 1 | |
| ) | |
| sleep -Seconds $initialWaitInSeconds | |
| while ($ie.Busy) { | |
| sleep -milliseconds 50 | |
| } | |
| } | |
| <# | |
| .Synopsis | |
| Invoke a java script function. | |
| .DESCRIPTION | |
| Use this function to run JavaScript on a web page. Your $Command can | |
| return a value which will be returned by this function unless $global | |
| switch is specified in which case $Command will be executed in global | |
| scope and cannot return a value. If you received error 80020101 it means | |
| you need to fix your JavaScript code. | |
| .EXAMPLE | |
| Invoke-JavaScript -IE $ie -Command 'Post.IsSubmitReady();setTimeout(function() {Post.SubmitCreds(); }, 1000);' | |
| .EXAMPLE | |
| $result = Invoke-JavaScript -IE $ie -Command 'Post.IsSubmitReady();setTimeout(function() {Post.SubmitCreds(); }, 1000);' -Global | |
| #> | |
| function Invoke-JavaScript { | |
| [CmdletBinding()] | |
| [OutputType([string])] | |
| Param | |
| ( | |
| [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)] | |
| $IE, | |
| [Parameter(Mandatory=$true, Position=1)] | |
| $Command, | |
| [switch]$Global | |
| ) | |
| if (-not $Global.IsPresent) { | |
| $Command = "document.body.setAttribute('PSResult', (function(){ $Command })());" | |
| } | |
| $document = $IE.document | |
| $window = $document.parentWindow | |
| $window.execScript($Command, 'javascript') | Out-Null | |
| if (-not $Global.IsPresent) { | |
| return $document.body.getAttribute('PSResult') | |
| } | |
| } | |
| function Trust-SPAddIn { | |
| [CmdletBinding(SupportsShouldProcess=$true)] | |
| [OutputType([int])] | |
| Param | |
| ( | |
| [Parameter(Mandatory=$true, Position=0)] | |
| [guid]$AppInstanceId, | |
| [Parameter(Mandatory=$true, Position=1)] | |
| [string]$WebUrl, | |
| [parameter(Mandatory=$true, Position=2)] | |
| [string]$UserName, | |
| [parameter(Mandatory=$true, Position=3)] | |
| [string]$Password | |
| ) | |
| $authorizeURL = "$($WebUrl.TrimEnd('/'))/_layouts/15/appinv.aspx?AppInstanceId={$AppInstanceId}" | |
| $ie = New-Object -com internetexplorer.application | |
| try | |
| { | |
| $ie.Visible = $false | |
| $ie.Navigate2($authorizeURL) | |
| WaitFor-IEReady $ie | |
| Write-Verbose $ie.Document.Title -Verbose | |
| if ($ie.Document.Title -match "Sign in to Office 365.*") { | |
| Write-Verbose "Authenticate $UserName to O365..." | |
| # Authorize against O365 | |
| $useAnotherLink = $ie.Document.getElementById("use_another_account_link") | |
| if ($useAnotherLink) { | |
| WaitFor-IEReady $ie | |
| $useAnotherLink.Click() | |
| WaitFor-IEReady $ie | |
| } | |
| $credUseridInputtext = $ie.Document.getElementById("cred_userid_inputtext") | |
| $credUseridInputtext.value = $UserName | |
| $credPasswordInputtext = $ie.Document.getElementById("cred_password_inputtext") | |
| $credPasswordInputtext.value = $Password | |
| WaitFor-IEReady $ie | |
| # make a jQuery call | |
| $result = Invoke-JavaScript -IE $ie -Command "`nPost.IsSubmitReady();`nsetTimeout(function() {`nPost.SubmitCreds();`n}, 1000);" | |
| WaitFor-IEReady $ie -initialWaitInSeconds 5 | |
| } | |
| Write-Verbose $ie.Document.Title -Verbose | |
| if ($ie.Document.Title -match "Do you trust.*") | |
| { | |
| sleep -seconds 5 | |
| $button = $ie.Document.getElementById("ctl00_PlaceHolderMain_BtnAllow") | |
| if ($button -eq $null) { | |
| $button = $ie.Document.getElementById("ctl00_PlaceHolderMain_LnkRetrust") | |
| } | |
| if ($button -eq $null) { | |
| throw "Could not find button to press" | |
| }else{ | |
| $button.click() | |
| WaitFor-IEReady $ie | |
| #if the button press was successful, we should now be on the Site Settings page.. | |
| if ($ie.Document.title -like "*trust*") { | |
| throw "Error: $($ie.Document.body.getElementsByClassName("ms-error").item().InnerText)" | |
| }else{ | |
| Write-Verbose "App was trusted successfully!" | |
| } | |
| } | |
| }else{ | |
| throw "Unexpected page '$($ie.LocationName)' was loaded. Please check your url." | |
| } | |
| } | |
| finally | |
| { | |
| $ie.Quit() | |
| } | |
| } | |
| Write-Host "Look for '$AppName' in '$applicationPath'..." | |
| $appPackage = Get-ChildItem -Path $applicationPath -Recurse -Include $AppName | |
| if (-not($appPackage)){ throw "No ap ppackage '$AppName' found in '$applicationPath'..." } | |
| Write-Host "Get package informations and set url in package to '$RemoteAppUrl'" | |
| $appPackageInformations = Get-AppPackageInformations -Path $appPackage.FullName -AppWebUrl $RemoteAppUrl | |
| Load-Assemblies | |
| Write-Host "Connect to '$WebUrl' as '$DeployUserName'..." | |
| $clientContext = New-Object Microsoft.SharePoint.Client.ClientContext($webUrl) | |
| $clientContext.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($DeployUserName, (ConvertTo-SecureString $DeployPassword -AsPlainText -Force)) | |
| try | |
| { | |
| $web = $clientContext.Web | |
| $clientContext.Load($web) | |
| $clientContext.ExecuteQuery(); | |
| Write-Host "Successfully connected to '$WebUrl'..." | |
| Write-Host "Update SharePoint app '$AppName' in '$WebUrl' to Version '$($appPackageInformations.Version)'..." | |
| $appId = Install-App -clientContext $clientContext -appPackage $appPackage.FullName -productId $appPackageInformations.ProductID | |
| Write-Host "Done." | |
| Write-Host "Trust the app." | |
| Trust-SPAddIn -AppInstanceId $appId -WebUrl $WebUrl -UserName $DeployUserName -Password $DeployPassword | |
| } | |
| finally | |
| { | |
| $clientContext.Dispose() | |
| } |