Updated

.github/workflows/build.yml

@@ -0,0 +1,31 @@
+name: Build
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ dev ]
+    paths: 'src/**'
+  pull_request:
+    branches: [ dev ]
+    paths: 'src/**'
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Setup .NET Core
+      uses: actions/setup-dotnet@v1
+      with:
+        dotnet-version: 3.1.301
+    - name: Install dependencies
+      run: dotnet restore
+      working-directory: src
+    - name: Build
+      run: dotnet build --configuration Release --no-restore
+      working-directory: src
+    - name: Test
+      run: dotnet test --no-restore --verbosity normal
+      working-directory: src

.github/workflows/publishtogallery.yml

@@ -0,0 +1,28 @@
+name: Nightly Release to PowerShell Gallery
+
+on:
+  workflow_dispatch:
+  schedule:
+  - cron: '0 1 * * *'
+jobs:
+  build:
+
+    runs-on: windows-latest
+
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        ref: dev
+    - name: Build and Publish Module
+      env:
+        POWERSHELLGALLERY_API_KEY: ${{ secrets.POWERSHELLGALLERY_API_KEY }}
+      shell: pwsh
+      run: |
+        ./build/Build-Release.ps1
+    - name: Add & Commit
+      uses: EndBug/add-and-commit@v4.2.1
+    - name: Push changes to github
+      uses: ad-m/github-push-action@v0.6.0
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        branch: dev

.gitignore

@@ -216,3 +216,5 @@ ModelManifest.xml
 
 # TabsStudio generated files
 *.tss
+
+.vscode/

CHANGELOG.md

@@ -24,6 +24,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Renamed `Save-PnPProvisioningTemplate` to `Save-PnPSiteTemplate`.
 - Renamed `Set-PnPProvisioningTemplateMetadata` to `Set-PnPSiteTemplateMetadata`.
 - Renamed `Add-PnPProvisioningTemplate` to `Add-PnPSiteTemplate`.
+- Renamed `Apply-PnPTenantTemplate` to `Invoke-PnPTenantTemplate`.
 - Removed `Get-PnPAppInstance`. Use `Get-PnPApp` instead.
 - Removed `Import-PnPAppPackage`. Use `Instal-PnPApp` instead.
 - Removed `Uninstall-AppInstance`. Use `Uninstall-PnPApp` instead.

README.md

@@ -3,7 +3,7 @@
 ### Summary ###
 This solution contains a library of PowerShell commands that allows you to perform complex provisioning and artifact management actions towards SharePoint. The commands use a combination of CSOM and REST behind the scenes, and can work against both SharePoint Online as SharePoint On-Premises.
 
-![Microsoft 365 Patterns and Practices](https://devofficecdn.azureedge.net/media/Default/PnP/sppnp.png)
+![Microsoft 365 Patterns and Practices](https://raw.githubusercontent.com/pnp/media/40e7cd8952a9347ea44e5572bb0e49622a102a12/parker/ms/300w/parker-ms-300.png)
 
 ### Applies to ###
 -  Sharepoint Online

build/Build-Debug.ps1

@@ -0,0 +1,116 @@
+$versionObject = [System.Version]::new($(Get-Content ..\version.txt -Raw))
+
+$buildVersion = $versionObject.Build + 1;
+
+$version = "$($versionObject.Major).$($versionObject.Minor).$buildVersion"
+
+Write-Host "Building PnP.PowerShell version $version" -ForegroundColor Yellow
+
+dotnet build ../src/Commands/PnP.PowerShell.csproj --nologo --configuration Debug -p:VersionPrefix=$version -p:VersionSuffix=preview
+
+$documentsFolder = [environment]::getfolderpath("mydocuments");
+
+if($IsLinux -or $isMacOS)
+{
+	$destinationFolder = "$documentsFolder/.local/share/powershell/Modules/PnP.PowerShell"
+} else {
+	$destinationFolder = "$documentsFolder/PowerShell/Modules/PnP.PowerShell"
+}
+
+$corePath = "$destinationFolder/Core"
+$commonPath = "$destinationFolder/Common"
+$frameworkPath = "$destinationFolder/Framework"
+
+Try {
+	# Module folder there?
+	if(Test-Path $destinationFolder)
+	{
+		# Yes, empty it
+		Remove-Item $destinationFolder\* -Recurse -Force -ErrorAction Stop
+	}
+		# No, create it
+	Write-Host "Creating target folders: $destinationFolder" -ForegroundColor Yellow
+	New-Item -Path $destinationFolder -ItemType Directory -Force | Out-Null
+	New-Item -Path "$destinationFolder\Core" -ItemType Directory -Force | Out-Null
+	New-Item -Path "$destinationFolder\Common" -ItemType Directory -Force | Out-Null
+	if(!$IsLinux -and !$IsMacOs)
+	{
+		New-Item -Path "$destinationFolder\Framework" -ItemType Directory -Force | Out-Null
+	}
+
+	Write-Host "Copying files to $destinationFolder" -ForegroundColor Yellow
+
+	$commonFiles = [System.Collections.Generic.Hashset[string]]::new()
+	Copy-Item -Path "../src/Commands/bin/Debug/netcoreapp3.1/ModuleFiles/*.ps1xml" -Destination "$destinationFolder"
+	Get-ChildItem -Path "$PSScriptRoot/../src/ALC/bin/Debug/netstandard2.0" | Where-Object {$_.Extension -in '.dll','.pdb' } | Foreach-Object { [void]$commonFiles.Add($_.Name); Copy-Item -LiteralPath $_.FullName -Destination $commonPath }
+	Get-ChildItem -Path "$PSScriptRoot/../src/Commands/bin/Debug/netcoreapp3.1" | Where-Object {$_.Extension -in '.dll','.pdb' -and -not $commonFiles.Contains($_.Name) } | Foreach-Object { Copy-Item -LiteralPath $_.FullName -Destination $corePath }
+	if(!$IsLinux -and !$IsMacOs)
+	{
+		Get-ChildItem -Path "$PSScriptRoot/../src/Commands/bin/Debug/net461" | Where-Object {$_.Extension -in '.dll','.pdb' -and -not $commonFiles.Contains($_.Name) } | Foreach-Object { Copy-Item -LiteralPath $_.FullName -Destination $frameworkPath }
+	}
+}
+Catch
+{
+	Write-Host "Error: Cannot copy files to $destinationFolder. Maybe a PowerShell session is still using the module?"
+	exit 1
+}
+
+Try {
+	Write-Host "Generating PnP.PowerShell.psd1" -ForegroundColor Yellow
+	# Load the Module in a new PowerShell session
+	$scriptBlock = {
+		$documentsFolder = [environment]::getfolderpath("mydocuments");
+
+		if($IsLinux -or $isMacOS)
+		{
+			$destinationFolder = "$documentsFolder/.local/share/powershell/Modules/PnP.PowerShell"
+		} else {
+			$destinationFolder = "$documentsFolder/PowerShell/Modules/PnP.PowerShell"
+		}
+
+		Import-Module -Name "$destinationFolder/Core/PnP.PowerShell.dll" -DisableNameChecking
+		$cmdlets = get-command -Module PnP.PowerShell | ForEach-Object{"`"$_`""}
+		$cmdlets -Join ","
+	}
+	$cmdletsString = Start-Job -ScriptBlock $scriptBlock | Receive-Job -Wait
+
+	$manifest = "@{
+	NestedModules =  if (`$PSEdition -eq 'Core')
+	{
+		'Core/PnP.PowerShell.dll'
+	}
+	else
+	{
+		'Framework/PnP.PowerShell.dll'
+	}
+	ModuleVersion = '$version'
+	Description = 'Microsoft 365 Patterns and Practices PowerShell Cmdlets'
+	GUID = '0b0430ce-d799-4f3b-a565-f0dca1f31e17'
+	Author = 'Microsoft 365 Patterns and Practices'
+	CompanyName = 'Microsoft 365 Patterns and Practices'
+	CompatiblePSEditions = @(`"Core`",`"Desktop`")
+	PowerShellVersion = '5.1'
+	DefaultCommandPrefix = 'PnP'
+	DotNetFrameworkVersion = '4.6.1'
+	ProcessorArchitecture = 'None'
+	FunctionsToExport = '*'  
+	CmdletsToExport = @($cmdletsString)
+	VariablesToExport = '*'
+	AliasesToExport = '*'
+	FormatsToProcess = 'PnP.PowerShell.Format.ps1xml' 
+	PrivateData = @{
+		PSData = @{
+			Prerelease = '-preview'
+			ProjectUri = 'https://aka.ms/sppnp'
+			IconUri = 'https://raw.githubusercontent.com/pnp/media/40e7cd8952a9347ea44e5572bb0e49622a102a12/parker/ms/300w/parker-ms-300.png'
+		}
+	}
+}"
+	$manifest | Out-File "$destinationFolder/PnP.PowerShell.psd1"
+}
+Catch 
+{
+	Write-Host "Error: Cannot generate PnP.PowerShell.psd1. Maybe a PowerShell session is still using the module?"
+	exit 1
+}
+