Feature: Add ToDo list management commands and update Viva Engage com…

…munity privacy setting

CHANGELOG.md

@@ -48,7 +48,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Added `-ListPermissionScopes` parameter on `Get-PnPAccessToken` cmdlet to list the current permission scopes on the current access token.
 - Added `Get-PnPCopilotAgent` cmdlet that returns the Microsoft Copilot Agents in a site collection.
 - Added `Get-PnPFileRetentionLabel` cmdlet to fetch the file retention labels. [#4603](https://github.com/pnp/powershell/pull/4603)
-- Added `Get/Set/Remove-PnPUserProfilePhoto` cmdlet to download, upload or remove the profile photo of the specified user.
+- Added `Get/Set/Remove-PnPUserProfilePhoto` cmdlets to download, upload or remove the profile photo of the specified user.
+- Added `New/Get/Remove/Update-PnPTodoList` cmdlets to manage Todo lists.
 
 ### Changed
 

documentation/Get-PnPTodoList.md

@@ -0,0 +1,106 @@
+---
+Module Name: PnP.PowerShell
+title: Get-PnPTodoList
+schema: 2.0.0
+applicable: SharePoint Online
+external help file: PnP.PowerShell.dll-Help.xml
+online version: https://pnp.github.io/powershell/cmdlets/Get-PnPTodoList.html
+---
+
+# Get-PnPTodoList
+
+## SYNOPSIS
+
+**Required Permissions**
+
+  * Microsoft Graph API : One of Tasks.Read, Tasks.ReadWrite, Tasks.Read.All
+
+Gets one Todo list or all Todo lists.
+
+## SYNTAX
+
+```powershell
+Get-PnPTodoList [[-Identity] <String>] [-[User] <AzureADUserPipeBind>]
+```
+
+## DESCRIPTION
+Use the cmdlet to retrieve all Todo lists or a specific Todo list.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Get-PnPTodoList
+```
+
+This will return all your (logged-in user) todo lists.
+
+### EXAMPLE 2
+```powershell
+Get-PnPTodoList -Identity "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVmLWFiMTkyYmQxODRjOQAuAAAAAACQV8RStyZCQJ4ydzjIK5HmAQD2LFcxdwYMRqbupn47nEYYAASUnLfyAAA="
+```
+
+This will return your (logged-in user) todo list with the specified Id.
+
+### EXAMPLE 3
+```powershell
+Get-PnPTodoList -User john@doe.com
+```
+
+This will return the todo lists for the user john.
+
+### EXAMPLE 4
+```powershell
+Get-PnPTodoList -User john@doe.com -Identity "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVmLWFiMTkyYmQxODRjOQAuAAAAAACQV8RStyZCQJ4ydzjIK5HmAQD2LFcxdwYMRqbupn47nEYYAASUnLfyAAA="
+```
+
+This will return the todo list for the user john with specified Id.
+
+## PARAMETERS
+
+### -Identity
+Id of the Todo list.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -User
+The UPN, Id or instance of an Azure AD user for which you would like to retrieve the todo list available to this user
+
+```yaml
+Type: AzureADUserPipeBind
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -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
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+

documentation/New-PnPTodoList.md

@@ -0,0 +1,92 @@
+---
+Module Name: PnP.PowerShell
+title: New-PnPTodoList
+schema: 2.0.0
+applicable: SharePoint Online
+external help file: PnP.PowerShell.dll-Help.xml
+online version: https://pnp.github.io/powershell/cmdlets/New-PnPTodoList.html
+---
+
+# New-PnPTodoList
+
+## SYNOPSIS
+
+**Required Permissions**
+
+  * Microsoft Graph API : One of Tasks.ReadWrite, Tasks.ReadWrite.All
+
+Creates a new todo list.
+
+## SYNTAX
+
+```powershell
+New-PnPTodoList [[-DisplayName] <String>] [-[User] <AzureADUserPipeBind>]
+```
+
+## DESCRIPTION
+Use the cmdlet to create a Todo list.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+New-PnPTodoList -DisplayName "Travel items"
+```
+
+This will create a todo list associated with your (logged-in user) account.
+
+### EXAMPLE 2
+```powershell
+New-PnPTodoList -User john@doe.com -DisplayName "Travel Items"
+```
+
+This will create a todo list associated with John's account.
+
+## PARAMETERS
+
+### -DisplayName
+Display name of the Todo list.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -User
+The UPN, Id or instance of an Azure AD user for which you would like to create the todo list.
+
+```yaml
+Type: AzureADUserPipeBind
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -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
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+

documentation/Remove-PnPTodoList.md

@@ -0,0 +1,92 @@
+---
+Module Name: PnP.PowerShell
+title: Remove-PnPTodoList
+schema: 2.0.0
+applicable: SharePoint Online
+external help file: PnP.PowerShell.dll-Help.xml
+online version: https://pnp.github.io/powershell/cmdlets/Remove-PnPTodoList.html
+---
+
+# Remove-PnPTodoList
+
+## SYNOPSIS
+
+**Required Permissions**
+
+  * Microsoft Graph API : Tasks.ReadWrite
+
+Removes a new todo list.
+
+## SYNTAX
+
+```powershell
+Remove-PnPTodoList [[-Identity] <String>] [-[User] <AzureADUserPipeBind>]
+```
+
+## DESCRIPTION
+Use the cmdlet to delete a Todo list.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Remove-PnPTodoList -Identity "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVmLWFiMTkyYmQxODRjOQAuAAAAAACQV8RStyZCQJ4ydzjIK5HmAQD2LFcxdwYMRqbupn47nEYYAASYG0vWAAA="
+```
+
+This will delete a todo list with specified Id associated with your (logged-in user) account.
+
+### EXAMPLE 2
+```powershell
+Remove-PnPTodoList -Identity "AAMkAGU4MGE1OTRiLTUzMGEtNDRjZi05ZmVmLWFiMTkyYmQxODRjOQAuAAAAAACQV8RStyZCQJ4ydzjIK5HmAQD2LFcxdwYMRqbupn47nEYYAASYG0vWAAA=" -User john@doe.com
+```
+
+This will delete a todo list with specified Id associated with John's account.
+
+## PARAMETERS
+
+### -Identity
+Id of the Todo list.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -User
+The UPN, Id or instance of an Azure AD user for which you would like to create the todo list.
+
+```yaml
+Type: AzureADUserPipeBind
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -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
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
+