Merge branch 'dev' into fix/4370

Author: KoenZomers

.github/workflows/buildpr.yml

@@ -44,10 +44,10 @@ jobs:
       run: dotnet build --configuration Debug --no-restore -p:WarningLevel=0
       working-directory: pnpcore/src/sdk/PnP.Core
     - name: Install PnP.Framework dependencies
-      run: dotnet restore -p:PnPCoreSdkPath="..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\netstandard2.0\PnP.Core.dll" -p:PnPCoreSdkPathNet6="..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net6.0\PnP.Core.dll" -p:PnPCoreSdkPathNet7="..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net7.0\PnP.Core.dll" -p:PnPCoreSdkPathNet8="..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net8.0\PnP.Core.dll"
+      run: dotnet restore -p:PnPCoreSdkPath="..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\netstandard2.0\PnP.Core.dll" -p:PnPCoreSdkPathNet8="..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net8.0\PnP.Core.dll"
       working-directory: pnpframework/src/lib
     - name: Build PnP.Framework
-      run: dotnet build --configuration Debug --no-restore -p:WarningLevel=0 -p:PnPCoreSdkPath="..\..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\netstandard2.0\PnP.Core.dll" -p:PnPCoreSdkPathNet6="..\..\..\..\pnpcore/src/sdk\PnP.Core\bin\Debug\net6.0\PnP.Core.dll" -p:PnPCoreSdkPathNet7="..\..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net7.0\PnP.Core.dll" -p:PnPCoreSdkPathNet8="..\..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net8.0\PnP.Core.dll"
+      run: dotnet build --configuration Debug --no-restore -p:WarningLevel=0 -p:PnPCoreSdkPath="..\..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\netstandard2.0\PnP.Core.dll" -p:PnPCoreSdkPathNet8="..\..\..\..\pnpcore\src\sdk\PnP.Core\bin\Debug\net8.0\PnP.Core.dll"
       working-directory: pnpframework/src/lib/PnP.Framework
     - name: Install PnP.PowerShell dependencies
       run: dotnet restore -p:PnPFrameworkPath="..\..\..\pnpframework\src\lib\" -p:PnPCoreSdkPath="..\..\..\pnpcore\src\sdk\"

CHANGELOG.md

@@ -29,6 +29,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Added `Get-PnPDeletedFlow` cmdlet to retrieve a list of flows which are soft deleted. [#4396](https://github.com/pnp/powershell/pull/4396)
 - Added `Restore-PnPFlow` cmdlet which allows for undeleting a flow within 21 days of deletion. [#4415](https://github.com/pnp/powershell/pull/4415)
 - Added `-ExcludeDeprecated` to `Export-PnpTaxonomy` which allows for deprecated terms to be excluded from the export [#4053](https://github.com/pnp/powershell/pull/4053)
+- Added `-HidePeoplePreviewingFiles` to `Set-PnPSite` which allows for hiding the people previewing files feature on a site [#4416](https://github.com/pnp/powershell/pull/4416)
+- Added `-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled` to `Set-PnPTenant` which allows for updating of web property bag when DenyAddAndCustomizePages is enabled [#4508](https://github.com/pnp/powershell/pull/4508)
+- Added `SiteId` to the output of `Get-PnPTenantSite` [#4527](https://github.com/pnp/powershell/pull/4527)
 
 ### Changed
 
@@ -64,6 +67,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Fixed `Get-PnPAzureADAppSitePermission`, `Grant-PnPAzureADAppSitePermission` and `Revoke-PnPAzureADAppSitePermission` cmdlets throwing an error when the site URL is not specified and the app registration used only having Graph permissions [#4421](https://github.com/pnp/powershell/pull/4421)
 - Fixed `Get-PnPTerm` cmdlet not working correctly when `-ParentTerm` parameter is specified. [#4454](https://github.com/pnp/powershell/pull/4454)
 - Fixed the PnP PowerShell version check to only check nightly version in nightly builds and major version in release builds. [#4453](https://github.com/pnp/powershell/pull/4453)
+- Fixed `-ConsistencyLevelEventual` flag on `Invoke-PnPGraphMethod` to work correctly. [#4523](https://github.com/pnp/powershell/pull/4523)
+- Fixed `Get-PnPServiceHealthIssue` returning an error when certain service states were active [#4530](https://github.com/pnp/powershell/pull/4530)
 
 ### Removed
 
@@ -77,6 +82,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 ### Contributors
 
 - Antti K. Koskela [koskila]
+- Steve Beaugé [stevebeauge]
+- [reusto]
+- Fredrik Thorild [fthorild]
 - San [sankarkumar23]
 - Christian Veenhuis [ChVeen]
 - Nishkalank Bezawada [NishkalankBezawada]
@@ -532,7 +540,6 @@ Fixed app registration on Windows
 - Kunj Balkrishna Sangani [kunj-sangani]
 - Dayana Hristova [makarovv]
 - Rodrigo Pinto [ScoutmanPt]
-- [reusto]
 - Reshmee Auckloo [reshmee011]
 - Dan Toft [Tanddant]
 - [reusto]

documentation/Add-PnPPage.md

@@ -23,7 +23,7 @@ Add-PnPPage [-Name] <String> [-LayoutType <PageLayoutType>]
 ```
 
 ## DESCRIPTION
-Creates a new page. The page will be located inside the Site Pages library of the site currently connected to.
+Creates a new page. The page will be located inside the Site Pages library of the site currently connected to. If the library does not exist yet, tries to ensure it is created.
 
 ## EXAMPLES
 
@@ -32,21 +32,21 @@ Creates a new page. The page will be located inside the Site Pages library of th
 Add-PnPPage -Name "NewPage"
 ```
 
-Creates a new page named 'NewPage'
+Creates a new page named 'NewPage'. The resulting file will accordingly be named 'NewPage.aspx'. If a file with that name already exists, executing the commandlet will fail.
 
 ### EXAMPLE 2
 ```powershell
 Add-PnPPage -Name "NewPage" -Title "Welcome to my page"
 ```
 
-Creates a new page NewPage.aspx with the title as provided
+Creates a new page NewPage.aspx with the title as provided.
 
 ### EXAMPLE 3
 ```powershell
 Add-PnPPage -Name "NewPage" -ContentType "MyPageContentType"
 ```
 
-Creates a new page named 'NewPage' and sets the content type to the content type specified
+Creates a new page named 'NewPage' and sets the content type to the content type specified.
 
 ### EXAMPLE 4
 ```powershell
@@ -67,14 +67,14 @@ Creates a new page named 'NewPage' under 'Folder' folder and saves as a template
 Add-PnPPage -Name "NewPage" -HeaderLayoutType ColorBlock
 ```
 
-Creates a new page named 'NewPage' using the ColorBlock header layout
+Creates a new page named 'NewPage' using the ColorBlock header layout.
 
 ### EXAMPLE 7
 ```powershell
 Add-PnPPage -Name "NewPage" Article -ScheduledPublishDate (Get-Date).AddHours(1)
 ```
 
-Creates a new page named 'NewPage' using the article layout and schedule it to be published in 1 hour from now
+Creates a new page named 'NewPage' using the article layout and schedule it to be published in 1 hour from now.
 
 ### EXAMPLE 8
 ```powershell
@@ -116,7 +116,7 @@ Accept wildcard characters: False
 ```
 
 ### -CommentsEnabled
-Enables or Disables the comments on the page
+Enables or Disables the comments on the page.
 
 ```yaml
 Type: SwitchParameter
@@ -144,7 +144,7 @@ Accept wildcard characters: False
 ```
 
 ### -HeaderLayoutType
-Type of layout used for the header
+Type of layout used for the header.
 
 ```yaml
 Type: PageHeaderLayoutType
@@ -188,12 +188,12 @@ Accept wildcard characters: False
 ```
 
 ### -PromoteAs
-Allows to promote the page for a specific purpose (HomePage | NewsPage)
+Allows to promote the page for a specific purpose (HomePage | NewsPage).
 
 ```yaml
 Type: PagePromoteType
 Parameter Sets: (All)
-Accepted values: None, HomePage, NewsArticle, Template
+Accepted values: None, HomePage, NewsArticle
 
 Required: False
 Position: Named
@@ -231,7 +231,7 @@ Accept wildcard characters: False
 ```
 
 ### -Translate
-Creates multilingual pages for all the languages specified in the site collection
+Creates multilingual pages for all the languages specified in the site collection.
 
 ```yaml
 Type: SwitchParameter

documentation/Connect-PnPOnline.md

@@ -282,7 +282,7 @@ Connects to the Azure AD with WAM (aka native Windows authentication prompt), ac
 
 WAM is a more secure & faster way of authenticating in Windows OS. It supports Windows Hello, FIDO keys , conditional access policies and more.
 
-### EXAMPLE 9
+### EXAMPLE 19
 ```powershell
 $keyStorageflags = [System.Security.Cryptography.X509Certificates.X509KeyStorageFlags]::MachineKeySet -bor [System.Security.Cryptography.X509Certificates.X509KeyStorageFlags]::PersistKeySet
 
@@ -294,6 +294,15 @@ See [Security App-only EntraId guidance](https://learn.microsoft.com/sharepoint/
 
 See [X509 key storage flags](https://learn.microsoft.com/dotnet/api/system.security.cryptography.x509certificates.x509keystorageflags) for information on how to configure key storage when creating the certificate.
 
+### EXAMPLE 20
+```powershell
+Connect-PnPOnline -Url "https://contoso.sharepoint.com" -Credentials "https://contoso.sharepoint.com"
+```
+
+Connect to SharePoint using Credentials (username and password) from Credential Manager (Windows) or Keychain (Mac) with the specified name to use to authenticate.
+
+On Windows, this entry needs to be under "Generic Credentials".
+
 ## PARAMETERS
 
 ### -AccessToken

documentation/Get-PnPFlow.md

@@ -14,6 +14,10 @@ title: Get-PnPFlow
 **Required Permissions**
 
 * Azure: management.azure.com
+* Azure Service Management : user_impersonation
+* Dynamics CRM : user_impersonation
+* PowerApps Service : User
+* Link to Required permissions reference : https://pnp.github.io/powershell/articles/determinepermissions.html#help-i-cant-figure-out-which-permissions-i-need
 
 Returns Power Automate Flows
 

documentation/Get-PnPMicrosoft365GroupSettings.md

@@ -20,7 +20,7 @@ Gets a settings of a specific Microsoft 365 Group or a tenant wide Microsoft 365
 ## SYNTAX
 
 ```powershell
-Get-PnPMicrosoft365GroupSettings [-Identity <Microsoft365GroupPipeBind>] 
+Get-PnPMicrosoft365GroupSettings [-Identity <Microsoft365GroupPipeBind>] [-GroupSetting <Microsoft365GroupSettingsPipeBind>] 
 ```
 
 ## DESCRIPTION
@@ -43,6 +43,22 @@ Get-PnPMicrosoft365GroupSettings -Identity $groupId
 
 Retrieves a specific Microsoft 365 Group setting
 
+
+### EXAMPLE 3
+```powershell
+Get-PnPMicrosoft365GroupSettings -GroupSetting $groupSettingId
+```
+
+Retrieves a tenant-wide specific Microsoft 365 Group setting.
+
+
+### EXAMPLE 4
+```powershell
+Get-PnPMicrosoft365GroupSettings -Identity $groupId -GroupSetting $groupSettingId 
+```
+
+Retrieves a group-specific Microsoft 365 Group setting
+
 ## PARAMETERS
 
 ### -Identity
@@ -59,10 +75,25 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -GroupSetting
+The Identity of the Microsoft 365 Group Setting
+
+```yaml
+Type: Microsoft365GroupSettingsPipeBind
+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)
-[Microsoft Graph documentation](https://learn.microsoft.com/graph/api/groupsetting-get)
+[Microsoft Graph documentation get settings](https://learn.microsoft.com/graph/api/groupsetting-get)
+[Microsoft Graph documentation list settings](https://learn.microsoft.com/en-gb/graph/api/group-list-setting)
 
 

documentation/Get-PnPSiteVersionPolicy.md

@@ -12,6 +12,12 @@ title: Get-PnPSiteVersionPolicy
 ## SYNOPSIS
 Get version policy setting of the site.
 
+**Required Permissions**
+
+|        Type      |                    API/ Permission Name                    |                    Admin consent required                    |
+| --------------- | --------------------------------------- | -------- |
+| Delegated       | AllSites.FullControl | yes                               |
+
 ## SYNTAX
 
 ```powershell

documentation/Get-PnPTenantInfo.md

@@ -12,6 +12,9 @@ online version: https://pnp.github.io/powershell/cmdlets/Get-PnPTenantInfo.html
 ## SYNOPSIS
 Gets information about any tenant
 
+** Required Permissions **
+Graph: CrossTenantInformation.ReadBasic.All
+
 ## SYNTAX
 
 ### Current Tenant (default)

documentation/Get-PnPUPABulkImportStatus.md

@@ -27,6 +27,15 @@ Get-PnPUPABulkImportStatus [-JobId <Guid>] [-IncludeErrorDetails] [-Connection <
 ## DESCRIPTION
 Retrieve information about the status of submitted user profile bulk upload jobs.
 
+Possible statuses are defined in the [ImportProfilePropertiesJobState enumeration](https://learn.microsoft.com/previous-versions/office/sharepoint-csom/mt643017(v=office.15)):
+
+- Unknown
+- Submitted
+- Processing
+- Queued
+- Succeeded
+- Error
+
 ## EXAMPLES
 
 ### EXAMPLE 1
@@ -103,5 +112,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)

documentation/Set-PnPSite.md

@@ -310,6 +310,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -HidePeoplePreviewingFiles
+Allows hiding of the presence indicators of users simultaneously editing files.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: Url
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Identity
 The url of the site collection.
 

documentation/Set-PnPSiteVersionPolicy.md

@@ -12,6 +12,13 @@ online version: https://pnp.github.io/powershell/cmdlets/Set-PnPSiteVersionPolic
 ## SYNOPSIS
 Sets file version policy related properties on the site.
 
+**Required Permissions**
+
+|        Type      |                    API/ Permission Name                    |                    Admin consent required                    |
+| --------------- | --------------------------------------- | -------- |
+| Delegated       | AllSites.FullControl | yes                               |
+
+
 ## SYNTAX
 
 ```powershell

documentation/Set-PnPTenant.md

@@ -160,6 +160,9 @@ Set-PnPTenant [-SpecialCharactersStateInFileFolderNames <SpecialCharactersState>
  [-GuestSharingGroupAllowListInTenantByPrincipalIdentity <string[]>]
  [-OneDriveSharingCapability <SharingCapabilities>]
  [-DelayDenyAddAndCustomizePagesEnforcement <Boolean>]
+ [-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>]
+ [-SelfServiceSiteCreationDisabled <Boolean>]
+ [-SyncAadB2BManagementPolicy]
  [-Force] [-Connection <PnPConnection>]
 ```
 
@@ -242,6 +245,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled
+Enables or disables web property bag update when DenyAddAndCustomizePages is enabled. When AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled is set to $true, web property bag can be updated even if DenyAddAndCustomizePages is turned on when the user had AddAndCustomizePages (prior to DenyAddAndCustomizePages removing it).
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ApplyAppEnforcedRestrictionsToAdHocRecipients
 When the feature is enabled, all guest users are subject to conditional access policy. By default guest users who are accessing SharePoint Online files with pass code are exempt from the conditional access policy.
 
@@ -2814,6 +2831,35 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -SelfServiceSiteCreationDisabled
+Sets whether self-service site creation is disabled.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SyncAadB2BManagementPolicy
+This feature allows SharePoint Online to synchronize several Entra B2B collaboration settings [Guest user access restriction and collaboration restriction](https://learn.microsoft.com/en-us/entra/external-id/external-collaboration-settings-configure#configure-settings-in-the-portal), and store them on SharePoint Online tenant store. On sharing, SharePoint checks whether those synchronized settings are blocking sharing before sending invitation requests to Entra B2B invitation manager. The sync might take up to 24 hours to complete if you change those Entra B2B collaboration settings. To make the change effective on SharePoint Online immediately, run 'Set-PnPTenant -SyncAadB2BManagementPolicy' and it forces a sync from Microsoft Entra.
+
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Force
 If provided, no confirmation will be requested and the action will be performed