Merge pull request #2348 from SharePoint/dev

November 2019 Release

Author: erwinvanhunen

Binaries/SharePointPnP.Modernization.Framework.dll

@@ -5,14 +5,34 @@ 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/).
 
-## [Unreleased]
+## [3.15.1911.0]
 
 ### Added
 
+- Added Request-PnPAccessToken to retrieve an OAuth2 access token using the password grant.
+- Added additional properties to Set-PnPHubSite
+- Added Get-PnPHubSiteChild cmdlet to list all child sites of a hubsite
+- ConvertTo-PnPClientSidePage: Added support for user mapping via `-UserMappingFile, `-LDAPConnectionString` and `-SkipUserMapping` parameters  #2340
+- ConvertTo-PnPClientSidePage: Added support for defining the target folder of a transformed page via `-TargetPageFolder`
+- Added Get-PnPSearchSettings to retreive current search settings for a site
+- Added Set-PnPSearchSettings to set search related settings on a site
+
 ### Changed
 
+- Cmdlets related to provisioning and tenant templates now output more detailed error information in case of a schema issue.
+- Fixes issue where site design was not being applied when using New-PnPSite
+- Fixed incorrect usage of SwitchParameter in Set-PnPSite cmdlet
+- Fixed issue when connecting to single level domain URLs
+- Disabled TimeZone as mandatory parameter for New-PnPTenantSite when using an on-premises version of PnP PowerShell
+
 ### Contributors
 
+- Gautam Sheth [gautamdsheth]
+- Koen Zomers [KoenZomers]
+- Laurens Hoogendoorn [laurens1984]
+- Jens Otto Hatlevold [jensotto]
+- Paul Bullock [pkbullock]
+
 ## [3.14.1910.1]
 
 ### Added

Binaries/SharePointPnP.Modernization.Framework.xml

@@ -1,10 +1,8 @@
 #if !ONPREMISES
-using Microsoft.Online.SharePoint.TenantAdministration;
 using Microsoft.SharePoint.Client;
 using SharePointPnP.PowerShell.CmdletHelpAttributes;
 using SharePointPnP.PowerShell.Commands.Base;
 using SharePointPnP.PowerShell.Commands.Base.PipeBinds;
-using System;
 using System.Management.Automation;
 
 namespace SharePointPnP.PowerShell.Commands.Admin
@@ -22,11 +20,10 @@ public class GetHubSite : PnPAdminCmdlet
 
         protected override void ExecuteCmdlet()
         {
-            if (this.Identity != null)
+            if (Identity != null)
             {
-                HubSiteProperties hubSiteProperties;
-                hubSiteProperties = base.Tenant.GetHubSitePropertiesByUrl(this.Identity.Url);
-                ClientContext.Load<HubSiteProperties>(hubSiteProperties);
+                var hubSiteProperties = Identity.GetHubSite(Tenant);
+                ClientContext.Load(hubSiteProperties);
                 ClientContext.ExecuteQueryRetry();
                 WriteObject(hubSiteProperties);
             }

Binaries/release/SharePointPnP.Modernization.Framework.dll

@@ -0,0 +1,50 @@
+#if !ONPREMISES
+using Microsoft.Online.SharePoint.TenantAdministration;
+using Microsoft.SharePoint.Client;
+using SharePointPnP.PowerShell.CmdletHelpAttributes;
+using SharePointPnP.PowerShell.Commands.Base;
+using SharePointPnP.PowerShell.Commands.Base.PipeBinds;
+using System;
+using System.Management.Automation;
+using Resources = SharePointPnP.PowerShell.Commands.Properties.Resources;
+
+namespace SharePointPnP.PowerShell.Commands.Admin
+{
+    [Cmdlet(VerbsCommon.Get, "PnPHubSiteChild")]
+    [CmdletHelp(@"Retrieves all sites linked to a specific hub site",
+        "Retrieves all sites linked to a specific hub site",
+        Category = CmdletHelpCategory.TenantAdmin,
+        SupportedPlatform = CmdletSupportedPlatform.Online)]
+    [CmdletExample(Code = @"PS:> Get-PnPHubChildSite -Identity https://contoso.sharepoint.com/sites/myhubsite", Remarks = "Returns the sites having configured the provided hub site as their hub site", SortOrder = 1)]
+    public class GetHubSiteChild : PnPAdminCmdlet
+    {
+        [Parameter(ValueFromPipeline = true, Mandatory = true, HelpMessage = "The URL of the hubsite for which to receive the sites refering to it")]
+        public HubSitePipeBind Identity { get; set; }
+
+        protected override void ExecuteCmdlet()
+        {
+            HubSiteProperties hubSiteProperties;
+            try
+            {
+                hubSiteProperties = Identity.GetHubSite(Tenant);
+                ClientContext.Load(hubSiteProperties, h => h.ID);
+                ClientContext.ExecuteQueryRetry();
+            }
+            catch (ServerException ex)
+            {
+                if (ex.ServerErrorTypeName.Equals("System.IO.FileNotFoundException"))
+                {
+                    throw new ArgumentException(Resources.SiteNotFound, nameof(Identity));
+                }
+
+                throw ex;
+            }
+
+            // Get the ID of the hubsite for which we need to find child sites
+            var hubSiteId = hubSiteProperties.ID;
+
+            WriteObject(Tenant.GetHubSiteChildUrls(hubSiteId), true);
+        }
+    }
+}
+#endif

Binaries/release/SharePointPnP.Modernization.Framework.xml

@@ -28,7 +28,7 @@ public class GrantHubSiteRights : PnPAdminCmdlet
 
         protected override void ExecuteCmdlet()
         {
-            base.Tenant.GrantHubSiteRights(Identity.Url, Principals, Rights);
+            base.Tenant.GrantHubSiteRights(Identity.Url ?? Identity.GetHubSite(Tenant).SiteUrl, Principals, Rights);
             ClientContext.ExecuteQueryRetry();
         }
     }

CHANGELOG.md

@@ -130,7 +130,7 @@ protected override void ExecuteCmdlet()
                 {
                     creationInformation.HubSiteId = HubSiteId.Id;
                 }
-                if (ParameterSetName == "CommunicationCustomInDesign")
+                if (ParameterSetName == ParameterSet_COMMUNICATIONCUSTOMDESIGN)
                 {
                     creationInformation.SiteDesignId = _communicationSiteParameters.SiteDesignId.Id;
                 }

Commands/Admin/GetHubSite.cs

@@ -55,7 +55,11 @@ public class NewTenantSite : PnPAdminCmdlet
         [Parameter(Mandatory = false, HelpMessage = @"Specifies the site collection template type. Use the Get-PnPWebTemplates cmdlet to get the list of valid templates. If no template is specified, one can be added later. The Template and LocaleId parameters must be a valid combination as returned from the Get-PnPWebTemplates cmdlet.")]
         public string Template = "STS#0";
 
+#if ONPREMISES
+        [Parameter(Mandatory = false, HelpMessage = "Use Get-PnPTimeZoneId to retrieve possible timezone values")]
+#else
         [Parameter(Mandatory = true, HelpMessage = "Use Get-PnPTimeZoneId to retrieve possible timezone values")]
+#endif
         public int TimeZone;
 
         [Parameter(Mandatory = false, HelpMessage = @"Specifies the quota for this site collection in Sandboxed Solutions units. This value must not exceed the company's aggregate available Sandboxed Solutions quota. The default value is 0. For more information, see Resource Usage Limits on Sandboxed Solutions in SharePoint 2010 : http://msdn.microsoft.com/en-us/library/gg615462.aspx.")]