Merge pull request #3129 from gautamdsheth/feature/2350

Feature #2350 - Add support for vertical column emphasis

Author: gautamdsheth

CHANGELOG.md

@@ -22,7 +22,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Added `-OpenInNewTab` parameter to `Add-PnPNavigationNode` cmdlet to allow links to be opened in a new tab. [#3094](https://github.com/pnp/powershell/pull/3094)
 - Added `-ArchiveRedirectUrl` to `Set-PnPTenant` allowing the configuration of a custom page to be shown when navigating to an archived SharePoint Online site [#3100](https://github.com/pnp/powershell/pull/3100)
 - Added `-BlockSendLabelMismatchEmail` to `Set-PnPTenant` allowing the warning e-mail being sent when uploading a file with a higher sensitivity label than the site it is being uploaded to to be disabled. [#3113](https://github.com/pnp/powershell/pull/3113)
-- Added `Move-PnPTerm` and `Move-PnPTermSet` cmdlets to allow moving the terms and termsets. [#2989](https://github.com/pnp/powershell/pull/2989) 
+- Added `Move-PnPTerm` and `Move-PnPTermSet` cmdlets to allow moving the terms and termsets. [#2989](https://github.com/pnp/powershell/pull/2989)
+- Added `-VerticalZoneEmphasis` parameter to `Add-PnPPageSection` cmdlet to allow setting the emphasis value for vertical columns.
 
 ### Fixed
 

documentation/Add-PnPPageSection.md

@@ -16,7 +16,7 @@ Adds a new section to a page
 
 ```powershell
 Add-PnPPageSection [-Page] <PagePipeBind> -SectionTemplate <CanvasSectionTemplate>
- [-Order <Int32>] [-ZoneEmphasis <Int32>] [-Connection <PnPConnection>]
+ [-Order <Int32>] [-ZoneEmphasis <Int32>] [-VerticalZoneEmphasis <Int32>] [-Connection <PnPConnection>]
  
 ```
 
@@ -56,6 +56,15 @@ PS> Add-PnPPageSection -Page $page -SectionTemplate OneColumn -ZoneEmphasis 2
 
 Adds a new one column section to the page 'MyPage' and sets the background to 2 (0 is no background, 3 is highest emphasis)
 
+### EXAMPLE 4
+```powershell
+$page = Add-PnPPage -Name "MyPage"
+PS> Add-PnPPageSection -Page $page -SectionTemplate OneColumnVerticalSection -Order 1 -ZoneEmphasis 2 -VerticalZoneEmphasis 3
+```
+
+Adds a new one column with one vertical section to the page 'MyPage' and sets the zone emphasis to 2 for one column and vertical zone emphasis to 3 for the vertical column.
+
+
 ## PARAMETERS
 
 ### -Connection
@@ -131,8 +140,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-## RELATED LINKS
+### -VerticalZoneEmphasis
+Sets the background of the vertical section (default = 0).
+Works only for vertical column layouts, will be ignored for other layouts.
 
-[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+```yaml
+Type: Int32
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
 
+## RELATED LINKS
 
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

src/Commands/Pages/AddPageSection.cs

@@ -20,13 +20,16 @@ public class AddPageSection : PnPWebCmdlet
         [Parameter(Mandatory = false)]
         public int ZoneEmphasis = 0;
 
+        [Parameter(Mandatory = false)]
+        public int VerticalZoneEmphasis = 0;
+
         protected override void ExecuteCmdlet()
         {
             var page = Page?.GetPage(Connection);
 
             if (page != null)
             {
-                page.AddSection(SectionTemplate, Order, ZoneEmphasis);
+                page.AddSection(SectionTemplate, Order, ZoneEmphasis, VerticalZoneEmphasis);
                 page.Save();
             }
             else