Skip to content

Commit c8a18ba

Browse files
Update markdown, readability & doc metadata timestamp
1 parent 94a722b commit c8a18ba

File tree

1 file changed

+11
-9
lines changed

1 file changed

+11
-9
lines changed

docs/declarative-customization/site-design-pnp-provisioning.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Calling the PnP provisioning engine from a site script
33
description: Build a complete SharePoint site design using the PnP provisioning engine
4-
ms.date: 07/04/2020
4+
ms.date: 11/25/2020
55
localization_priority: Priority
66
---
77

88
# Calling the PnP provisioning engine from a site script
99

1010
> [!NOTE]
11-
> This article uses a version of PnP PowerShell that is currently in pre-release and planned to GA in January 2021. As Azure Functions run PowerShell Core, you will have to use this version of PnP PowerShell in your Azure function. For more information about this version of PnP PowerShell see https://pnp.github.io/powershell.
11+
> This article uses a version of PnP PowerShell that is currently in pre-release and planned to GA in January 2021. As Azure Functions run PowerShell Core, you'll have to use this version of PnP PowerShell in your Azure Function. For more information about this version of PnP PowerShell see https://pnp.github.io/powershell.
1212
1313
Site designs offer a great way to standardize the look and feel of your site collections. However, you can't do some things with site designs, like add a footer to every page. You can use the PnP provisioning engine to create a template that you can use to provision an Application Customizer to a site. This Application Customizer can then update your page design, for example to register a footer on every page.
1414

@@ -25,7 +25,7 @@ The steps in this article use the following components:
2525
- A PnP PowerShell script
2626
- An Azure AD App Registration
2727

28-
You will use these components to trigger the PnP provisioning code after you create the site and apply the site design.
28+
You'll use these components to trigger the PnP provisioning code after you create the site and apply the site design.
2929

3030
[!INCLUDE [pnp-provisioning-engine](../../includes/snippets/open-source/pnp-provisioning-engine.md)]
3131

@@ -38,14 +38,14 @@ We are going to use authentication with a clientid and a certificate in this tut
3838
```powershell
3939
Register-PnPAzureADApp -ApplicationName "PnPFlowDemo" -Tenant "contoso.onmicrosoft.com" -DeviceLogin -Out .
4040
```
41+
4142
Replace **contoso.onmicrosoft.com** with your tenant.
4243
4344
Follow the steps carefully.
4445
4546
As a result of the command a new Azure AD Application will be registered, permissions will be set correctly, and you will have provided consent to use this application in your tenant. Notice that you require write access to the Azure AD for this.
46-
1. Copy the values the cmdlet returns as you will need the pfx file and the AzureAppId value later.
47-
<br/>
4847
48+
1. Copy the values the cmdlet returns as you will need the pfx file and the AzureAppId value later.
4949
5050
## Create the Azure Queue storage
5151
@@ -62,7 +62,6 @@ To set up the Azure Queue storage:
6262
1. Enter **pnpprovisioningqueue** for the name, or enter your own value; be sure to follow the naming standard. Make note of the queue name; you will need this value when you create the Azure Function.
6363
1. Go to **Access Keys** and note the **Storage Account Name** and the **key1 Key value**. You will need these values when you create the flow.
6464
65-
6665
## Create the flow
6766
6867
To put a message in the queue, you need to create a flow.
@@ -106,7 +105,7 @@ To put a message in the queue, you need to create a flow.
106105
1. Choose the first step in your flow ('When an HTTP request is received') and copy the URL.
107106
1. Save your flow.
108107
109-
Your flow should look like the following.
108+
Your flow should look like the following:
110109
111110
![Screenshot of a flow named 'When an HTTP request is received', showing the URL, Request body, Queue name, and Message fields](images/pnpprovisioning-flow-overview.png)
112111
@@ -120,7 +119,7 @@ $body = "{webUrl:'somesiteurl'}"
120119
Invoke-RestMethod -Uri $uri -Method Post -ContentType "application/json" -Body $body
121120
```
122121

123-
When you go to the main screen of your flow, you will see a run history. If your flow worked correctly, it will show `Succeeded`.
122+
When you go to the main screen of your flow, you'll see a run history. If your flow worked correctly, it will show `Succeeded`.
124123
Now go to the queue you just created in Azure and choose **Refresh**. You should see an entry that shows that you correctly invoked the flow.
125124

126125
## Provision the SPFx solution
@@ -157,11 +156,14 @@ Copy the following provisioning template XML to a new file and save the file as
157156
1. Search for **Function App** and create a new function app. In the **Storage** field, select **Use existing**, and select the storage account that you created earlier. Set the other values as required, but make sure to select **PowerShell Core** as the **Runtime** and select **7.0** as the **Version**
158157

159158
![Screenshot of the Azure portal with the Runtime stack and Version fields hightlighted](images/pnpprovisioning-runtime-stack-selection.png)
159+
160160
1. When created, navigate to your new Function App
161161
1. Select **App Files**
162162

163163
![Screenshot of the Function App with the App Files entry highlighted in the menu](images/pnpprovisioning-app-files.menu.png)
164+
164165
1. In the dropdown menu, select **requirements.psd1** and add a new entry as follows
166+
165167
```powershell
166168
# This file enables modules to be automatically managed by the Functions service.
167169
# See https://aka.ms/functionsmanageddependency for additional information.
@@ -173,7 +175,7 @@ Copy the following provisioning template XML to a new file and save the file as
173175
'PnP.PowerShell' = '0.2.17-nightly'
174176
}
175177
```
176-
Save the file. Notice, that if you do no intent to use the Azure PowerShell Cmdlets you can remove that entry from this file. The requirements.psd1 file makes sure that specific PowerShell modules will be available to all functions. At the first execution of the Azure Function these modules will be downloaded and made available. You can also use wildcard references for the version. See for more information about this file here: https://docs.microsoft.com/en-us/azure/azure-functions/functions-reference-powershell?tabs=portal#dependency-management
178+
Save the file. Notice, that if you do no intent to use the Azure PowerShell Cmdlets you can remove that entry from this file. The requirements.psd1 file makes sure that specific PowerShell modules will be available to all functions. At the first execution of the Azure Function these modules will be downloaded and made available. You can also use wildcard references for the version. See for more information about this file here: https://docs.microsoft.com/azure/azure-functions/functions-reference-powershell?tabs=portal#dependency-management
177179
178180
1. Create a new Azure Function **Functions** > **Add**:
179181

0 commit comments

Comments
 (0)