Feature: Add Set-PnPVivaEngageCommunity cmdlet for updating Viva Engage community settings

Author: Gautam Sheth

documentation/Set-PnPVivaEngageCommunity.md

@@ -0,0 +1,115 @@
+---
+Module Name: PnP.PowerShell
+title: Set-PnPVivaEngageCommunity
+schema: 2.0.0
+applicable: SharePoint Online
+external help file: PnP.PowerShell.dll-Help.xml
+online version: https://pnp.github.io/powershell/cmdlets/Set-PnPVivaEngageCommunity.html
+---
+ 
+# Set-PnPVivaEngageCommunity
+
+## SYNOPSIS
+Updates the Viva engage community in the tenant.
+
+## SYNTAX
+
+```powershell
+Set-PnPVivaEngageCommunity [[-Identity] <string>] [[-DisplayName] <string>] [[-Description] <string>][[-Privacy] <CommunityPrivacy>] [-Connection <PnPConnection>] 
+```
+
+## DESCRIPTION
+
+Updates the Viva engage community.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Set-PnPVivaEngageCommunity -Identity "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIyMTI0ODA3MTI3MDQifQ" -DisplayName "New Viva Community"
+```
+
+This will update the display name of the Viva Engage community in the tenant with the specified Id.
+
+### EXAMPLE 2
+```powershell
+Set-PnPVivaEngageCommunity -Identity "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIyMTI0ODA3MTI3MDQifQ" -DisplayName "New Viva Community" -Description "Updated description" -Privacy Private
+```
+
+This will update the display name, description and privacy setting of the Viva Engage community in the tenant with the specified Id.
+
+## 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
+```
+
+### -Identity
+The Id of the Viva engage community.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: True
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -DisplayName
+The updated display name of the Viva engage community.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -Description
+The updated description of the Viva engage community.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -Privacy
+The updated privacy setting of the Viva engage community. Available values are `Public` and `Private`.
+
+```yaml
+Type: CommunityPrivacy
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

src/Commands/Viva/UpdateVivaEngageCommunity.cs

@@ -0,0 +1,45 @@
+using PnP.PowerShell.Commands.Attributes;
+using PnP.PowerShell.Commands.Base;
+using PnP.PowerShell.Commands.Model.VivaEngage;
+using System.Collections.Generic;
+using System.Management.Automation;
+
+namespace PnP.PowerShell.Commands.Viva
+{
+    [Cmdlet(VerbsCommon.Set, "PnPVivaEngageCommunity")]
+    [RequiredApiDelegatedOrApplicationPermissions("graph/Community.ReadWrite.All")]
+    public class UpdateVivaEngageCommunity : PnPGraphCmdlet
+    {
+        [Parameter(Mandatory = true, Position = 0)]
+        public string Identity;
+
+        [Parameter(Mandatory = false)]
+        public string DisplayName;
+
+        [Parameter(Mandatory = false)]
+        public string Description;
+
+        [Parameter(Mandatory = false)]
+        public CommunityPrivacy Privacy;
+        protected override void ExecuteCmdlet()
+        {
+            string endpointUrl = $"/v1.0/employeeExperience/communities/{Identity}";
+
+            var postData = new Dictionary<string, string>();
+
+            if (ParameterSpecified(nameof(DisplayName)))
+            {
+                postData.Add("displayName", DisplayName);
+            }
+            if (ParameterSpecified(nameof(Description)))
+            {
+                postData.Add("description", Description);
+            }
+            if (ParameterSpecified(nameof(Privacy)))
+            {
+                postData.Add("privacy", Privacy.ToString().ToLower());
+            }
+            RequestHelper.Patch(endpointUrl, postData);
+        }
+    }
+}