When provisioning SP Starter Kit following the deployment process, common outputs including the following.
All examples are based on running the following commands in PowerShell, where [yourtenant] is replaced with your specific tenant id.
Connect-PnPOnline https://[yourtenant].sharepoint.com
Apply-PnPTenantTemplate -Path starterkit.pnp- Successful provisioning
- ERROR: General cascading errors
- ERROR: Improper version of PnP PowerShell installed
- ERROR: App Catalog Required
- ERROR: Term Set Permissions Required
- ERROR: Not Targeted Release
- ERROR: Culture is not supported and/or (0x0c00) is an invalid culture identifier.
- Invalid App package installation - API Management missing
If all pre-requirements have been addressed and met, no errors should be generated.
Watch the pre-requirements If you see many cascading errors, most likely a pre-requirement has not been set.
-
Ensure you are connecting to your tenant site using a tenant admin account.
-
Ensure that you have the latest PnP PowerShell commandlets. You might need to remove the PnP PowerShell commandlets and re-install to ensure you have the latest.
PnP PowerShell - Recommended 3.19.2003.0 or later. -
Your tenant must be set to
targeted releasefor all users, and you must wait at least 24 hours after setting targeted release for all users before running deploy.ps1. -
Verify you have already created your
tenant app catalog. -
Verify that the account you are using has Admin rights to the Site Collection for tenant app catalog (eg. /sites/appcatalog)
-
Verify the account you are using to connect to your tenant site has already been added as a term store administrator.
-
If you believe the error is new and not addressed below or in the
issues list, please submit anew issue. If the error appears to be an error reported in PowerShell, please enable the PnP Trace Log before running the deploy.ps1 script and report those findings in your new issue.Set-PnPTraceLog -On -Level Debug
PnP PowerShell - Recommended 3.19.2003.0 or later is required for SP Starter Kit to properly provision. It is recommended that you have only the latest version of PnP PowerShell installed on your workstation as well.
If you do not have the proper version of PnP PowerShell installed, you may receive errors similar to:
Apply-PnPTenantTemplate : The term 'Apply-PnPTenantTemplate' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
Verify you have the latest PnP PS commandlets installed, as well as look for competeting, older versions. If you receive any error that references that a given term is not recognized as the name of a cmdlet, function, script file, or operable program, you have an issue with how PnP PowerShell is installed on your workstation.
Get-Module SharePointPnPPowerShell* -ListAvailable | Select-Object Name,Version | Sort-Object Version -Descending
`Update PnP PowerShell'
Update-Module SharePointPnPPowerShell*`Remove older verions(s) of PnP PowerShell'
Based on the example above, we can see there are two versions of PnP PS installed. We could remove version 2.23.1802.0 with the following command:
Get-InstalledModule -Name "SharePointPnPPowerShellOnline" -RequiredVersion 2.23.1802.0 | Uninstall-ModuleAlternatively you can decide to uninstall all installed version of PnP PowerShell and reinstall the latest module
Uninstall-Module -Name "SharePointPnPPowerShellOnline" -AllVersions
Install-Module -Name "SharePointPnPPowerShellOnline"The SP Starter Kit includes multiple SPFx solution packages, *.sppkg. By default these packages will be deployed to the tenant app catalog by the Apply-PnPTenantTemplate cmdlet in to your tenant App Catalog.
If you have not completed this task, you might receive an error that includes:
WARNING: Tenant app catalog doesn't exist. ALM step will be skipped!
Apply-PnPTenantTemplate : There is no app catalog site for this tenant.
Create a tenant app catalog and wait for deployment to complete, which may take minutes, hours, or possibly a day.
Note: If you recently created a new tenant or an Office 365 Developer tenant, you may receive an error similar to:
Sorry, something went wrong
Updates are currently disallowed on GET requests. To allow updates on a GET, set the 'AllowUnsafeUpdates' property on SPWeb.
You may need to wait a few hours, possibly up to 24+ hours, after a new SharePoint tenant is created before creating a tenant app catalog as it takes a while for your SharePoint tenant to fully deploy.
The deployment script includes a PnP provisioning template that attempts to configure demo terms within the managed metadata service / term store. For this to succeed, the account used to connect to your tenant must have been manually added as a term store administator. If you have not completed this task, you might receive an error that includes:
Apply-PnPProvisioningHierarchy : Access denied. You do not have permissions to perform this action or access this resource.
Verify that the account you are using to provision SP Starter Kit is a term store administrator.
SP Starter Kit requires that your tenant be set to Targeted Release for all users. When the deployment script attempts to provision solution.xml to your tenant, included is an action to upload the included .sppkg SPFx solution to your tenant app catalog as well as approve API permissions. This step fails if you have not properly configured your tenant to Targeted Release.
An error may appear similar to the following:
Apply-PnPProvisioningHierarchy : {"error":{"code":"-2147024891, System.UnauthorizedAccessException","message":"{"lang","en-us","value":"Access denied. You do not have permissions to perform this action or access this resource."}}}
`This error can also appear if the login account is not an owner of the 'App Catalog' for the tenant
Ensure that your tenant is set to targeted release for all users.
NOTE: You will need to wait at least 24 hours after setting your tenant to targeted release before all required updates are provisioned to your tenant before the deploy script will execute correctly.
The SP Starter Kit end to end provisioning only works with tenants that are configured with the dafault language set to English, i.e. those with culture code 1033 enabled. It is possible that certain tenants have English available, while the default language is not set to 1033. This can cause issues when the provisioning process adds terms to to the term store.
You may receive an error in PowerShell similar to the following:
Culture is not supported(0x0c00) is an invalid culture identifier.Check to see that the current culture for your instance of PowerShell is ready for the template. Run "Get-Culture" in PowerShell
Get-CultureThe expected output should be
LCID Name DisplayName
---- ---- -----------
1033 en-US English (Unitied States)You can temporarily change to en-US for the provisioning process to continue.
Set-Culture -CultureInfo en-USTry to provision the Starter Kit again.
Deployment of the included SPFx solutions .\source\[component]\sharepoint\solution\[component].sppkg may be completed manually. If you do not have Targeted Release enabled for all users, or if you have enabled Targeted Release for all users but have not waited at least 24 hours to full roll out, you may encounter errors when manually deploying the .sppgk packages, or attempting to find API Management.
Manually deploying .sppkg packages
Although you will be able to upload the SPFx package to the tenant app catalog, an error will be thrown.
API Management missing
Without Targeted Release enabled, you will be unable to find API Management in the Preview Admin Center.
Ensure that your tenant is set to targeted release for all users.
NOTE: You will need to wait at least 24 hours after setting your tenant to targeted release before all required updates are provisioned to your tenant before the deploy script will execute correctly.