Hi SharePoint guys,

powershellThanks to Modern Pages and the SharePoint Framework in SharePoint Online, we, as SharePoint specialists are able to offer our users a great user experience.

To deliver and maintain our solutions, we need to automate and standardize our deployments. For this, we can use tools based on PowerShell scripts.

Remote Provisioning

We know that, for some reasons, the Feature Framework and the declarative provisioning of assets is not the recommended approach anymore (I would dare to say : “Avoid it as much as possible!”).

We will prefer remote provisioning which is, in a sense: “Do programatically using APIs what you would do manually in the UI”, we will, that way, avoid any annoying Feature References. I encourage you to watch this webcast that explains these things pretty well.

The PnP Provisioning Engine

The PnP community distributes a core library that addresses a lot of boilerplate tasks SharePoint developers commonly have to do. This library ships an engine that relies on the various capabilities of the library to provision SharePoint assets according to an external template file. It is a great option to provision the assets and artifacts of an entire site. (e.g. Provision a site on-demand based on a template,  Deploy your application assets to different environments, ….)

 

PnP PowerShell

The PnP community also distributes an enormous set of PowerShell Cmdlets that wraps the features of the PnP Core library. If your deployment/provisioning tool needs some dynamic configuration or some scripted conditions, it then makes more sense to rather use PowerShell scripts to provision your assets than a “static” template.

In my humble opinion, it is even a totally valid approach to combine both. We could think of provisioning “default” assets with the provisioning engine (which can also be used through a PnP PowerShell cmdlet) and provision dynamically some stuff under certain conditions with, for instance, computed values.

To test the features described below, you need to install the PnP PowerShell module. You can either install a .msi package or use the Install-Module command in a PowerShell console (Check the GitHub repository for more info). 

NOTE: These capabilities are a fresh addition in the PnP PowerShell project, if you already installed it previously, make sure to upgrade it to the September 2017 release. Moreover, at the time of this writing, these are currently available only for the SharePoint Online platform.

SPFx solution samples

To test these capabilities, I suggest you to fetch my solution samples

  • The KanbanBoard WebPart
  • Some SPFx extensions samples

Both solutions can be fetched from my GitHub SPFx sample repo

To install them, you have to update the write-manifests.json file with your CDN location in both solutions, build the bundles and packages and upload the .sppkg‘s into your app catalog and the bundles files into your CDN location.

These solution leverage the new skipDeploymentFeature option.
package-skipfeaturedeploy

deploy-solution-kanban

However, it is absolutely not mandatory. But if you don’t choose that option, you will need to “add the app” on your target site.

Provision and manipulates Modern Pages and SPFx WebParts

 

Provision a new Modern Page

Configure the sections on a Modern Page

Add text and built-in WebParts on a Modern Page

Setup a WebPart on a Modern Page

Create a new Install-WebPart.ps1 file and put the following content in it. Adapt the default values and the properties to set on your WebPart.

[EDIT]
At the time of this writing (September, 10th 2017), I encounter an issue with the current release of the PnP PowerShell kit when I execute the script above. (It was originally written with the DEV branch of the project). I don’t know if it is only me. but if not, it should be fixed pretty soon.
This is now fixed. Please upgrade to latest version of PnP PowerShell (2.18.1709.1).

Setup your SPFx extensions

While extensions are also available in your whole tenant using the skipDeploymentFeature option, they require to be associated to either Custom actions (for Application Customizers and ListView Command Sets) or Field (Field Customizers).

Setup your ApplicationCustomizer extension

Pretty straightforward, this snippet allows you to associate your application customizer to your site.

Setup your FieldCustomizer extension

The PowerShell snippet below allows you to associate your FieldCustomizer to a list column. To associate to a site column instead, just drop the -List $list argument from the command line.

Setup your ListViewCommandSet extension

At the time of this writing, this one is just a bit more complex because of some inconsistencies in the Cmdlet arguments in the current release.

Conclusion

Using these PnP PowerShell cmdlets, you can either apply the provisioning template from a file (I will come back to it in a future blog post) and/or easily write complete and more complex scripts to provision your pages, configure their layout and options, add and configure your WebParts to your pages.

Hope you liked this post ! Please, give your feedback !

Yannick

Advertisements