Merge pull request #767 from pnp/dev

Release 1.6.0

Author: erwinvanhunen

.github/workflows/closestaleissues.yml

@@ -13,4 +13,5 @@ jobs:
         stale-issue-message: 'This issue is stale because it has been open 14 days with no activity. Remove stale label or comment or this will be closed in 5 days'
         days-before-stale: 14
         days-before-close: 5
+        exempt-issue-labels: 'enhancement'
         stale-issue-label: 'no-issue-activity'

CHANGELOG.md

@@ -5,10 +5,19 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 
-## [Current Nightly]
+## [1.6.0]
 
 ### Added
 
+### Changed
+
+- Get-PnPPage now can load pages living in a folder by specifying "folder/page.aspx"
+- Added `-DisableBackToClassic` option to Set-PnPTenant
+
+### Contributors
+- [thomassmart]
+- Bert Jansen [jansenbe]  
+
 ## [1.5.0]
 
 ### Added

README.md

@@ -6,7 +6,7 @@ Last version | Last nightly version
 -------------|---------------------
 [![PnP.PowerShell](https://img.shields.io/powershellgallery/v/pnp.powershell)](https://www.powershellgallery.com/packages/PnP.PowerShell/) | [![PnP.PowerShell](https://img.shields.io/powershellgallery/v/pnp.powershell?include_prereleases)](https://www.powershellgallery.com/packages/PnP.PowerShell/)
 
-This module is a successor of the [PnP-PowerShell](https://github.com/pnp/pnp-powershell) module. The original cmdlets only work on Windows and Windows PowerShell and supports SharePoint On-Premises (2013, 2016 and 2019) and SharePoint Online. This version of the cmdlets is cross-platform (e.g. it works on Windows, MacOS and Linux) however will only support SharePoint Online. Going forward will only be **actively maintaining the cross-platform PnP PowerShell** module.
+This module is a successor of the [PnP-PowerShell](https://github.com/pnp/pnp-powershell) module. The original cmdlets only work on Windows and Windows PowerShell and supports SharePoint On-Premises (2013, 2016 and 2019) and SharePoint Online. This version of the cmdlets is cross-platform (e.g. it works on Windows, MacOS and Linux) however will only support SharePoint Online. Going forward we will only be **actively maintaining the cross-platform PnP PowerShell** module.
 
 For more information about installing or upgrading to this module, please refer to the documentation at https://pnp.github.io/powershell/articles/index.html
 

documentation/Add-PnPContentType.md

@@ -30,6 +30,13 @@ Add-PnPContentType -Name "Project Document" -Description "Use for Contoso projec
 
 This will add a new content type based on the parent content type stored in the $ct variable.
 
+### EXAMPLE 2
+```powershell
+Add-PnPContentType -Name "Project Document" -Description "Use for Contoso projects" -Group "Contoso Content Types" -ParentContentType (Get-PnPContentType -Identity 0x0101) -DocumentTemplate "/_cts/Project Document/template.docx"
+```
+
+This will add a new content type based on the standard document content type and assigns the document template template.docx to it
+
 ## PARAMETERS
 
 ### -Connection
@@ -116,7 +123,19 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -DocumentTemplate
+Allows providing a server relative path to a file which should be used as the document template for this content type
+
+```yaml
+Type: String
+Parameter Sets: (All)
 
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
 
 ## RELATED LINKS
 

documentation/Add-PnPContentTypesFromContentTypeHub.md

@@ -0,0 +1,74 @@
+---
+Module Name: PnP.PowerShell
+schema: 2.0.0
+applicable: SharePoint Online
+online version: https://pnp.github.io/powershell/cmdlets/Add-PnPContentTypesFromContentTypeHub.html
+external help file: PnP.PowerShell.dll-Help.xml
+title: Add-PnPContentTypesFromContentTypeHub
+---
+  
+# Add-PnPContentTypesFromContentTypeHub
+
+## SYNOPSIS
+
+**Required Permissions**
+
+  * ManageLists permission on the current site or the content type hub site.
+
+Adds published content types from content type hub site to current site. If the content type already exists on the current site then the latest published version of the content type will be synced to the site.
+
+## SYNTAX
+
+```powershell
+Add-PnPContentTypesFromContentTypeHub -ContentTypes List<String>
+ [-Connection <PnPConnection>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+ $list = New-Object Collections.Generic.List[string]
+ $list.Add('0x0101')
+ $list.Add('0x01')
+Add-PnPContentTypesFromContentTypeHub -ContentTypes $list
+```
+
+This will add the content types with the ids '0x0101' and '0x01' to the current site. Latest published version of these content types will be synced if they were already present in the current site.
+
+## PARAMETERS
+
+### -Connection
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+
+```yaml
+Type: PnPConnection
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ContentTypes
+The list of content type ids present in content type hub site that are required to be added/synced to the current site.
+
+```yaml
+Type: List<String>
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+
+

documentation/Clear-PnpRecycleBinItem.md

@@ -2,7 +2,7 @@
 Module Name: PnP.PowerShell
 schema: 2.0.0
 applicable: SharePoint Online
-online version: https://pnp.github.io/powershell/cmdlets/Clear-PnpRecycleBinItem.html
+online version: https://pnp.github.io/powershell/cmdlets/Clear-PnPRecycleBinItem.html
 external help file: PnP.PowerShell.dll-Help.xml
 title: Clear-PnPRecycleBinItem
 ---
@@ -39,14 +39,14 @@ Permanently deletes all the items in the first and second stage recycle bins of
 
 ### EXAMPLE 2
 ```powershell
-Clear-PnpRecycleBinItem -Identity 72e4d749-d750-4989-b727-523d6726e442
+Clear-PnPRecycleBinItem -Identity 72e4d749-d750-4989-b727-523d6726e442
 ```
 
 Permanently deletes the recycle bin item with Id 72e4d749-d750-4989-b727-523d6726e442 from the recycle bin
 
 ### EXAMPLE 3
 ```powershell
-Clear-PnpRecycleBinItem -Identity $item -Force
+Clear-PnPRecycleBinItem -Identity $item -Force
 ```
 
 Permanently deletes the recycle bin item stored under variable $item from the recycle bin without asking for confirmation from the end user first

documentation/Connect-PnPOnline.md

@@ -1,7 +1,7 @@
 ---
 external help file: PnP.PowerShell.dll-Help.xml
 Module Name: PnP.PowerShell
-online version: https://pnp.github.io/powershell/cmdlets/connect-pnponline.html
+online version: https://pnp.github.io/powershell/cmdlets/Connect-PnPOnline.html
 schema: 2.0.0
 ---
 
@@ -175,8 +175,7 @@ By default it will use the PnP Management Shell multi-tenant application behind
 Connect-PnPOnline -Url "https://portal.contoso.com" -TransformationOnPrem -CurrentCredential
 ```
 
-Connects to on-premises SharePoint 2013, 2016 or 2019 site with the current user's on-premises Windows credential (e.g.
-domain\user).
+Connects to on-premises SharePoint 2013, 2016 or 2019 site with the current user's on-premises Windows credential (e.g. domain\user).
 This option is only supported for being able to transform on-premises classic wiki, webpart, blog and publishing pages into modern pages in a SharePoint Online site.
 Although other PnP cmdlets might work as well, they're officially not supported for being used in an on-premises context.
 See http://aka.ms/sharepoint/modernization/pages for more details on page transformation.
@@ -338,6 +337,22 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -CurrentCredentials
+Use credentials of the currently logged in user. Applicable exclusively when connecting to on premises SharePoint Server via PnP.
+Switch parameter.
+
+```yaml
+Type: CredentialPipeBind
+Parameter Sets: Credentials
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -DriveName
 Name of the PSDrive to create (default: SPO)
 
@@ -605,4 +620,4 @@ Accept wildcard characters: False
 
 ## RELATED LINKS
 
-[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

documentation/Copy-PnPFile.md

@@ -15,7 +15,7 @@ Copies a file or folder to a different location. This location can be within the
 ## SYNTAX
 
 ```powershell
-Copy-PnPFile [-SourceUrl] <String> [-TargetUrl] <String> [-OverwriteIfAlreadyExists] [-Force] [-IgnoreVersionHistory] [-NoWait] [-Connection <PnPConnection>]  
+Copy-PnPFile [-SourceUrl] <String> [-TargetUrl] <String> [-Overwrite] [-Force] [-IgnoreVersionHistory] [-NoWait] [-Connection <PnPConnection>]  
   [<CommonParameters>]
 ```
 
@@ -25,10 +25,10 @@ Copy-PnPFile [-SourceUrl] <String> [-TargetUrl] <String> [-OverwriteIfAlreadyExi
 
 ### EXAMPLE 1
 ```powershell
-Copy-PnPFile -SourceUrl "Shared Documents/MyProjectfiles" -TargetUrl "/sites/otherproject/Shared Documents" -OverwriteIfAlreadyExists
+Copy-PnPFile -SourceUrl "Shared Documents/MyProjectfiles" -TargetUrl "/sites/otherproject/Shared Documents" -Overwrite
 ```
 
-Copies a folder named MyDocs in the document library called Documents located in the current site to the root folder of the library named Documents in the site collection otherproject.
+Copies a folder named MyProjectFiles in the document library called Documents located in the current site to the root folder of the library named Documents in the site collection otherproject. If a folder named MyProjectFiles already exists, it will overwrite it.
 
 ### EXAMPLE 2
 ```powershell
@@ -39,10 +39,10 @@ Copies a file named company.docx located in a document library called Shared Doc
 
 ### EXAMPLE 3
 ```powershell
-Copy-PnPFile -SourceUrl "Shared Documents/company.docx" -TargetUrl "/sites/otherproject/Shared Documents"
+Copy-PnPFile -SourceUrl "Shared Documents/company.docx" -TargetUrl "/sites/otherproject/Shared Documents" -IgnoreVersionHistory
 ```
 
-Copies a file named company.docx located in a document library called Documents in the current site to the site collection otherproject. If a file named company.docx already exists, it won't perform the copy.
+Copies a file named company.docx located in a document library called Documents in the current site to the site collection otherproject. If a file named company.docx already exists, it won't perform the copy. Only the latest version of the file will be copied and its history will be discarded.
 
 ### EXAMPLE 4
 ```powershell
@@ -70,7 +70,7 @@ Copies a file named company.docx located in a document library called Documents
 Copy-PnPFile -SourceUrl "Shared DocuDocuments/company.docx" -TargetUrl "Subsite/Shared Documents"
 ```
 
-Copies a file named company.docx located in a document library called Documents to the document library named Document in a subsite named Subsite keeping the file name.
+Copies a file named company.docx located in a document library called Documents to the document library named Documents in a subsite named Subsite keeping the file name.
 
 ### EXAMPLE 8
 ```powershell
@@ -122,7 +122,7 @@ Accept wildcard characters: False
 ```
 
 ### -IgnoreVersionHistory
-If provided, only the latest version of the document will be copied and its history will be discared. If not provided, all historical versions will be copied along.
+If provided, only the latest version of the document will be copied and its history will be discarded. If not provided, all historical versions will be copied.
 
 ```yaml
 Type: SwitchParameter

documentation/Disable-PnPFlow.md

@@ -8,6 +8,11 @@ schema: 2.0.0
 # Disable-PnPFlow
 
 ## SYNOPSIS
+
+**Required Permissions**
+
+* Azure: management.azure.com
+
 Disables a specific flow
 
 ## SYNTAX

documentation/Enable-PnPFlow.md

@@ -8,6 +8,11 @@ schema: 2.0.0
 # Enable-PnPFlow
 
 ## SYNOPSIS
+
+**Required Permissions**
+
+* Azure: management.azure.com
+
 Enables a specific flow
 
 ## SYNTAX