Merge branch 'dev' into SetListItemDocs

.github/workflows/builddocsite.yml

@@ -13,22 +13,22 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Checkout master branch
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: master
           path: master
       - name: Checkout dev branch
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: dev
           path: dev
       - name: Checkout gh-pages branch
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: gh-pages
           path: gh-pages
       - name: Setup .NET 7.0
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 7.x
 

.github/workflows/buildexternalhelp.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Building Help File
       env:
         RUNSINACTION: 1

.github/workflows/buildpr.yml

@@ -17,23 +17,23 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout PnP.Framework
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         repository: pnp/pnpframework
         path: pnpframework
         ref: 'dev'
     - name: Checkout PnP.Core
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         repository: pnp/pnpcore
         path: pnpcore
         ref: 'dev'  
     - name: Checkout PnP.PowerShell
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         path: powershell
     - name: Setup .NET Core
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
         dotnet-version: |
            6.0.x

.github/workflows/checkdocumentationbuild.yml

@@ -12,20 +12,20 @@ jobs:
 
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           ref: master
           path: master
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           ref: dev
           path: dev
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           ref: gh-pages
           path: gh-pages
       - name: Setup .NET 7.0
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 7.x
 

.github/workflows/cleanupnightlyreleases.yml

@@ -14,11 +14,11 @@ jobs:
     # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
     # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with: 
         ref: dev
     - name: Setup .NET 6.0
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
         dotnet-version: '6.0.x'
     - name: Unlist nightly nuget packages

.github/workflows/nightlyrelease.yml

@@ -11,12 +11,12 @@ jobs:
 
     steps:
     - name: Setup .NET Core
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
         dotnet-version: | 
           6.x
           7.x
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         ref: dev
         token: ${{ secrets.PAT }}
@@ -41,7 +41,7 @@ jobs:
     runs-on: windows-2022
     needs: [ build ]
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build an image
       run: |
         $VERSION="$(cat ./version.txt)-nightly"
@@ -55,7 +55,7 @@ jobs:
     runs-on: windows-2019
     needs: [ build ]
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build an image
       run: |
         $VERSION="$(cat ./version.txt)-nightly"
@@ -69,7 +69,7 @@ jobs:
     runs-on: ubuntu-latest
     needs: [ build ]
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build an image
       run: |
         VERSION=$(cat ./version.txt)-nightly

.github/workflows/release.yml

@@ -8,7 +8,7 @@ jobs:
   publish-docker-windows-2022:
     runs-on: windows-2022
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build and Publish All
       shell: pwsh
       run: |
@@ -17,7 +17,7 @@ jobs:
   publish-docker-windows-2019:
     runs-on: windows-2019
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build and Publish All
       shell: pwsh
       run: |
@@ -26,7 +26,7 @@ jobs:
   publish-docker-linux:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Build and Publish All
       shell: pwsh
       run: |

CHANGELOG.md

@@ -15,17 +15,32 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Added `Convert-PnPFile` cmdlet which allows for a file to be converted to from one format to another. [#3435](https://github.com/pnp/powershell/pull/3435) & [#3643](https://github.com/pnp/powershell/pull/3643)
 - Added `Merge-PnPTerm` cmdlet which allows merging of one term into another. [#3638](https://github.com/pnp/powershell/pull/3638)
 - Added `Get-PnPDeletedContainer` cmdlet which returns a list of all deleted Containers in the recycle bin. [#3648](https://github.com/pnp/powershell/pull/3648)
+- Added `-Batch` parameter to `Add-PnPGroupMember` cmdlet which allows adding members to a SharePoint group in a batch. [#3651](https://github.com/pnp/powershell/pull/3651)
 - Added `Get-PnPContainerTypeConfiguration` cmdlet which fetches the container type configuration values. [#3660](https://github.com/pnp/powershell/pull/3660)
+- Added `-AppBypassInformationBarriers` and `-DefaultOneDriveInformationBarrierMode` parameters to `Set-PnPTenant` cmdlet. [#3679](https://github.com/pnp/powershell/pull/3679)
+- Added `Add-PnPFileAnalyticsData` cmdlet to allow retrieval of file analytics data. [#3644](https://github.com/pnp/powershell/pull/3644)
+- Added `Add-PnPSiteAnalyticsData` cmdlet to allow retrieval of site analytics data. [#3645](https://github.com/pnp/powershell/pull/3645)
+- Added `Get-PnPPowerPlatformSolution` cmdlet to Power Platform solutions. [#3675](https://github.com/pnp/powershell/pull/3675)
+- Added `New-PnPContainerType` cmdlet to create a new SharePoint container type. [#3669](https://github.com/pnp/powershell/pull/3669)
+- Added `Remove-PnPContainerType` cmdlet which removes a specific container type. [#3689](https://github.com/pnp/powershell/pull/3689/)
+- Added `Restore-PnPDeletedContainer` cmdlet which recovers a deleted Container from the Recycle Bin. [#3661](https://github.com/pnp/powershell/pull/3661)
+- Added 'Get-PnPWebPermission' cmdlet which retrieves permission given by user for specific web. (#3685)[https://github.com/pnp/powershell/pull/3685]
 
 ### Fixed
 
 - Fixed `Grant-PnPAzureADAppSitePermission` cmdlet which allows it to work in multi-geo environment. [#3658](https://github.com/pnp/powershell/pull/3658)
 - Fixed `Get-PnPTeamsChannelMessageReply` cmdlet which didn't work correctly when `-IncludeDeleted` parameter was not specified. [#3676](https://github.com/pnp/powershell/pull/3676)
 - Fixed `Add-PnPNavigationNode` cmdlet to also search for nodes in child navigation items. [#3625](https://github.com/pnp/powershell/pull/3625)
 - Fixed `Get-PnPFlow` cmdlet to use the newer Flow URLs instead of the old ARM URLs. [#3677](https://github.com/pnp/powershell/pull/3677)
+- Fixed `Get-PnPPowerPlatformConnector`, `Get-PnPPowerPlatformEnvironment`, `Get-PnPPowerApp`, `Add-PnPFlowOwner`, `Disable-PnPFlow`, `Enable-PnPFlow`, `Export-PnPFlow`, `Get-PnPFlowOwner`, `Get-PnPFlowRun`, `Remove-PnPFlow`, `Remove-PnPFlowOwner` , `Restart-PnPFlow` and `Stop-PnPFlowRun` cmdlets to use the new HTTP endpoints. [#3687](https://github.com/pnp/powershell/pull/3687)
+- Fixed `Add-PnPHubSiteAssociation` cmdlet to allow support for multi-geo scenario. [#3568](https://github.com/pnp/powershell/pull/3568)
 
 ### Contributors
 
+- Daniel Cecil [danielcecil]
+- Rohit Devmore [rohit404404]
+- Konrad K. [wilecoyotegenius]
+- Kunj Balkrishna Sangani [kunj-sangani]
 - Koen Zomers [koenzomers]
 - Reshmee Auckloo [reshme011]
 - Nishkalank Bezawada [NishkalankBezawada]

documentation/Add-PnPGroupMember.md

@@ -26,6 +26,12 @@ Add-PnPGroupMember -Group <GroupPipeBind> -EmailAddress <String> [-SendEmail] [-
  [-Connection <PnPConnection>] 
 ```
 
+### Batched
+```powershell
+Add-PnPGroupMember -LoginName <String> -Group <GroupPipeBind> 
+ [-Connection <PnPConnection>] -Batch <PnPBatch>
+```
+
 ## DESCRIPTION
 
 Allows to add new user to SharePoint group. The SharePoint group may be specified either by id, name or related object.
@@ -46,6 +52,16 @@ Add-PnPGroupMember -LoginName user@company.com -Group 5
 
 Add the specified user to the SharePoint group with Id 5
 
+### EXAMPLE 3
+```powershell
+$batch = New-PnPBatch
+Add-PnPGroupMember -LoginName user@company.com -Group 5 -Batch $batch
+Add-PnPGroupMember -LoginName user1@company.com -Group 5 -Batch $batch
+Invoke-PnPBatch $batch
+```
+
+Add the specified users to the SharePoint group with Id 5 in a batch.
+
 ## PARAMETERS
 
 ### -Connection
@@ -130,6 +146,19 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Batch
+
+```yaml
+Type: PnPBatch
+Parameter Sets: Batched
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 
 
 ## RELATED LINKS

documentation/Add-PnPListItem.md

@@ -187,46 +187,48 @@ Accept wildcard characters: False
 
 Use the internal names of the fields when specifying field names.
 
-Single line of text: -Values @{"Title" = "Title New"}
+Single line of text: ``` -Values @{"Title" = "Title New"} ```
 
-Multiple lines of text: -Values @{"MultiText" = "New text\n\nMore text"}
+Multiple lines of text:  ``` -Values @{"MultiText" = "New text\n\nMore text"} ```
 
-Rich text: -Values @{"MultiText" = "<strong>New</strong> text"}
+Rich text: ``` -Values @{"MultiText" = "<strong>New</strong> text"} ```
 
-Choice: -Values @{"Choice" = "Choice 1"}
+Choice: ``` -Values @{"Choice" = "Choice 1"} ```
 
-Multi-Choice: -Values @{"MultiChoice" = "Choice 1","Choice 2"}
+Multi-Choice: ``` -Values @{"MultiChoice" = "Choice 1","Choice 2"} ```
 
-Number: -Values @{"Number" = "10"}
+Number: ``` -Values @{"Number" = "10"} ```
 
-Currency: -Values @{"Currency" = "10"}
+Currency: ``` -Values @{"Currency" = "10"} ```
 
 > [!NOTE]
 > For numeric and currency fields, when using -Batch, provide the value using the comma and dots matching the regional setting of the site you're adding the listitem to. When not using batch, you must always provide the value in the American notation, so dot for decimals and comma for thousands separators.
 
-Date and Time: -Values @{"DateAndTime" = "03/13/2015 14:16"}
+Date and Time: ``` -Values @{"DateAndTime" = "03/13/2015 14:16"} ```
 
-Lookup (id of lookup value): -Values @{"Lookup" = "2"}
+Lookup (id of lookup value): ``` -Values @{"Lookup" = "2"} ```
 
-Multi value lookup (id of lookup values as array 1): -Values @{"MultiLookupField" = "1","2"}
+Multi value lookup (id of lookup values as array 1): ``` -Values @{"MultiLookupField" = "1","2"} ```
 
-Multi value lookup (id of lookup values as array 2): -Values @{"MultiLookupField" = 1,2}
+Multi value lookup (id of lookup values as array 2): ``` -Values @{"MultiLookupField" = 1,2} ```
 
-Multi value lookup (id of lookup values as string): -Values @{"MultiLookupField" = "1,2"}
+Multi value lookup (id of lookup values as string): ``` -Values @{"MultiLookupField" = "1,2"} ```
 
-Yes/No: -Values @{"YesNo" = $false}
+Yes/No: ``` -Values @{"YesNo" = $false} ```
 
-Person/Group (id of user/group in Site User Info List or email of the user, separate multiple values with a comma): -Values @{"Person" = "user1@domain.com","21"}
+Person/Group (id of user/group in Site User Info List or email of the user, separate multiple values with a comma): ``` -Values @{"Person" = "user1@domain.com","21"} ```
 
-Managed Metadata (single value with path to term): -Values @{"MetadataField" = "CORPORATE|DEPARTMENTS|FINANCE"}
+**If the user is not present, in the site user information list, you need to add that user using `New-PnPUser` cmdlet.**
 
-Managed Metadata (single value with id of term): -Values @{"MetadataField" = "fe40a95b-2144-4fa2-b82a-0b3d0299d818"} with Id of term
+Managed Metadata (single value with path to term): ``` -Values @{"MetadataField" = "CORPORATE|DEPARTMENTS|FINANCE"} ```
 
-Managed Metadata (multiple values with paths to terms): -Values @{"MetadataField" = "CORPORATE|DEPARTMENTS|FINANCE","CORPORATE|DEPARTMENTS|HR"}
+Managed Metadata (single value with id of term): ``` -Values @{"MetadataField" = "fe40a95b-2144-4fa2-b82a-0b3d0299d818"} with Id of term ```
 
-Managed Metadata (multiple values with ids of terms): -Values @{"MetadataField" = "fe40a95b-2144-4fa2-b82a-0b3d0299d818","52d88107-c2a8-4bf0-adfa-04bc2305b593"}
+Managed Metadata (multiple values with paths to terms): ``` -Values @{"MetadataField" = "CORPORATE|DEPARTMENTS|FINANCE","CORPORATE|DEPARTMENTS|HR"} ```
 
-Hyperlink or Picture: -Values @{"Hyperlink" = "https://github.com/OfficeDev/, OfficePnP"}
+Managed Metadata (multiple values with ids of terms): ``` -Values @{"MetadataField" = "fe40a95b-2144-4fa2-b82a-0b3d0299d818","52d88107-c2a8-4bf0-adfa-04bc2305b593"} ```
+
+Hyperlink or Picture: ``` -Values @{"Hyperlink" = "https://github.com/OfficeDev/, OfficePnP"} ```
 
 ```yaml
 Type: Hashtable

documentation/Get-PnPDeletedContainer.md

@@ -15,7 +15,7 @@ title: Get-PnPDeletedContainer
 
 * SharePoint: Access to the SharePoint Tenant Administration site
 
-The Get-SPODeletedContainer cmdlet returns a list of all deleted Containers in the Recycle Bin. There is no Identity parameter needed. The list includes the ContainerId, ContainerName, DeletedOn, and CreatedDate. Deleted Containers in the Recycle Bin are permanently deleted after 93 days. 
+The Get-PnPDeletedContainer cmdlet returns a list of all deleted Containers in the Recycle Bin. There is no Identity parameter needed. The list includes the ContainerId, ContainerName, DeletedOn, and CreatedDate. Deleted Containers in the Recycle Bin are permanently deleted after 93 days. Use cmdlet Restore-PnPDeletedContainer to restore a deleted container.
 
 ## SYNTAX
 
@@ -54,4 +54,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)