Merge branch 'unlockrecord' of https://github.com/reshmee011/powershell…

… into PR4457

.github/workflows/checkdocumentationbuild.yml

@@ -32,7 +32,7 @@ jobs:
         with:
           dotnet-version: 7.x
 
-      - run: dotnet tool update -g docfx
+      - run: dotnet tool install -g docfx --version 2.72.1
 
       - name: Build docs
         shell: pwsh

.github/workflows/nightlyrelease.yml

@@ -76,14 +76,14 @@ jobs:
     - name: Build an image
       run: |
         VERSION=$(cat ./version.txt)-nightly
-        docker build --build-arg "PNP_MODULE_VERSION=$VERSION" --build-arg "BASE_IMAGE_SUFFIX=lts-alpine-3.17" --build-arg "INSTALL_USER=root" --build-arg "SKIP_PUBLISHER_CHECK=False" ./docker -f ./docker/pnppowershell.dockerFile --tag ${{ secrets.DOCKER_ORG }}/powershell:$VERSION-lts-alpine-3.17;
+        docker build --build-arg "PNP_MODULE_VERSION=$VERSION" --build-arg "BASE_IMAGE_SUFFIX=alpine-3.20" --build-arg "INSTALL_USER=root" --build-arg "SKIP_PUBLISHER_CHECK=False" ./docker -f ./docker/pnppowershell.dockerFile --tag ${{ secrets.DOCKER_ORG }}/powershell:$VERSION-alpine-3.20;
     - name: Tag the image
       run: |
         VERSION=$(cat ./version.txt)-nightly
-        docker image tag ${{ secrets.DOCKER_ORG }}/powershell:$VERSION-lts-alpine-3.17 ${{ secrets.DOCKER_ORG }}/powershell:nightly
+        docker image tag ${{ secrets.DOCKER_ORG }}/powershell:$VERSION-alpine-3.20 ${{ secrets.DOCKER_ORG }}/powershell:nightly
     - name: Push the image
       run: |
         VERSION=$(cat ./version.txt)-nightly
         docker login -u ${{ secrets.DOCKER_USERNAME }} -p '${{ secrets.DOCKER_PASSWORD }}'
-        docker push ${{ secrets.DOCKER_ORG }}/powershell:$VERSION-lts-alpine-3.17
+        docker push ${{ secrets.DOCKER_ORG }}/powershell:$VERSION-alpine-3.20
         docker push ${{ secrets.DOCKER_ORG }}/powershell:nightly

.github/workflows/release.yml

@@ -34,4 +34,4 @@ jobs:
       shell: pwsh
       run: |
         $securedPassword = ConvertTo-SecureString "${{ secrets.DOCKER_PASSWORD }}" -AsPlainText -Force
-        ./docker/Publish-UnpublishedImage.ps1 PnP.PowerShell ${{ secrets.DOCKER_USERNAME }} ${{ secrets.DOCKER_ORG }} powershell $securedPassword "root" $false "lts-alpine-3.17"
+        ./docker/Publish-UnpublishedImage.ps1 PnP.PowerShell ${{ secrets.DOCKER_USERNAME }} ${{ secrets.DOCKER_ORG }} powershell $securedPassword "root" $false "alpine-3.20"

CHANGELOG.md

@@ -51,6 +51,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - 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.
 - Added `Set-PnPFileRetentionLabel` which allows setting a retention label on a file in SharePoint or locking/unlocking it. [#4457](https://github.com/pnp/powershell/pull/4457)
+- Added `Get-PnPFileCheckedOut` cmdlet to retrieve all files that are currently checked out in a library [#4682](https://github.com/pnp/powershell/pull/4682)
+- Added `Get-PnPTenantPronounsSetting` and `Set-PnPTenantPronounsSetting` cmdlets to manage the availability of using pronouns in the organization [#4660](https://github.com/pnp/powershell/pull/4660)
+- Added `HidePeopleWhoHaveListsOpen` parameter to `Set-PnPSite` cmdlet to hide people who simultaneously have lists open [#4699](https://github.com/pnp/powershell/pull/4699)
+- Added `-WhoCanShareAllowListInTenant`, `-LegacyBrowserAuthProtocolsEnabled`, `-EnableDiscoverableByOrganizationForVideos`, `-RestrictedAccessControlforSitesErrorHelpLink`, `-Workflow2010Disabled`, `-AllowSharingOutsideRestrictedAccessControlGroups`, `-HideSyncButtonOnDocLib`, `-HideSyncButtonOnODB`, `-StreamLaunchConfig`, `-EnableMediaReactions`, `-ContentSecurityPolicyEnforcement` and `-DisableSpacesActivation` to `Set-PnPTenant` [#4681](https://github.com/pnp/powershell/pull/4681)
 
 ### Changed
 
@@ -79,7 +83,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - `Add-PnPApp` , `Publish-PnPApp` , `Remove-PnPApp` and `Unpublish-PnPApp` now support disabling script settings if tenant app catalog is a no-script site.
 - `Send-PnPMail` now throws a warning about the retirement of the SharePoint SendEmail API.
 - `Get-PnPCustomAction` now supports a completer for `-Identity` and uses the PnP Core SDK to return custom actions.
-- `Set-PnPPropertyBagValue` and `Remove-PnPPropertyBagValue` now toggle the NoScript status of the site to allow setting/removing property bag values.
+- `Set-PnPPropertyBagValue` and `Remove-PnPPropertyBagValue` now toggle the NoScript status of the site to allow setting/removing property bag values, but only if the tenant wide `AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled` is not enabled [#4680](https://github.com/pnp/powershell/pull/4680)
 
 
 ### Fixed
@@ -101,7 +105,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Fixed `Add-PnPFileSensitivityLabel` cmdlet to allow empty string value to reset file sensitivity label.
 - Fix `Connect-PnPOnline` cmdlet not working with On Prem related cmdlets. [#4622](https://github.com/pnp/powershell/pull/4622)
 - Fix `Get\Invoke-PnPSiteTemplate` cmdlet not working in vanity domains. [#4630](https://github.com/pnp/powershell/pull/4630)
-
+- Fixed passing a `Get-PnPRecycleBinItem` result or a GUID to `Restore-PnPRecycleBinItem` not working correctly. [#4667](https://github.com/pnp/powershell/pull/4667)
+
 ### Removed
 
 - Removed `-LaunchBrowser`, `-NoPopup` and credential based auth on `Register-PnPEntraIDApp` and `Register-PnPEntraIDAppForInteractiveLogin` cmdlets. The default auth method is now Interactive.
@@ -126,6 +131,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 
 ### Contributors
 
+- Stephen Cox [stephen-cox-nzx]
+- Marijn Somers [Marijnsomers]
 - Janne Holm [jhholm]
 - Paul Bullock [pkbullock]
 - Arjan Cornelissen [arjancornelissen]

README.md

@@ -1,6 +1,6 @@
 # PnP PowerShell
 
-**PnP PowerShell** is a .NET 8 based PowerShell Module providing nearly 750 cmdlets that work with Microsoft 365 environments such as SharePoint Online, Microsoft Teams, Microsoft Project, Security & Compliance, Azure Active Directory, and more.
+**PnP PowerShell** is a .NET 8 based PowerShell Module providing over 750 cmdlets that work with Microsoft 365 environments such as SharePoint Online, Microsoft Teams, Microsoft Project, Security & Compliance, Entra ID, and more.
 
 Last version | Last nightly version
 -------------|---------------------

dependencies.json

@@ -1,6 +1,6 @@
 {
-  "Updated": "20241230-024548",
-  "PnPPowerShell": "7d2c9129f96bbdeb474a1c3c0f726dd1916934be",
-  "PnPFramework": "6e2e5031215d00f1b2a711a5a91c05f98963fed4",
-  "PnPCore": "fce75c35a047b38ccf344abb0a6f0dda3302d9a4"
+  "Updated": "20250122-024505",
+  "PnPPowerShell": "7323d2359bb9237523d52f7e40062ce01e5a94a6",
+  "PnPFramework": "812c522d9adb9322db937c413465683e5b5b8214",
+  "PnPCore": "317449f81705e1491e08828b6841aa093a6ea1d9"
 }

docker/Publish-UnpublishedImage.ps1

@@ -56,7 +56,7 @@ $moduleVersions | % {
             $plainStringPassword = [System.Net.NetworkCredential]::new("", $DOCKER_PASSWORD).Password;
             docker login -u $DOCKER_USERNAME -p "$plainStringPassword";
             docker push $DOCKER_ORG/$DOCKER_IMAGE_NAME`:$imageVersion;
-            if ( $baseImageSuffix -eq "lts-alpine-3.17") {
+            if ( $baseImageSuffix -eq "alpine-3.20") {
                 docker image tag $DOCKER_ORG/$DOCKER_IMAGE_NAME`:$imageVersion $DOCKER_ORG/$DOCKER_IMAGE_NAME`:latest;
                 docker push $DOCKER_ORG/$DOCKER_IMAGE_NAME`:latest;
             }

docker/pnppowershell.dockerFile

@@ -1,4 +1,4 @@
-ARG BASE_IMAGE_SUFFIX=lts-alpine-3.17
+ARG BASE_IMAGE_SUFFIX=alpine-3.20
 ARG BASE_IMAGE=mcr.microsoft.com/powershell:$BASE_IMAGE_SUFFIX
 FROM $BASE_IMAGE
 

documentation/Add-PnPOrgAssetsLibrary.md

@@ -131,14 +131,14 @@ Accept wildcard characters: False
 ```
 
 ### -OrgAssetType
-Indicates the type of content in this library. Currently supported values are "ImageDocumentLibrary" and "OfficeTemplateLibrary".
+Indicates the type of content in this library.
 
 ImageDocumentLibrary is the default OrgAssetType and is best used for images. You can access the contents of this library from any site or page in the SharePoint filepicker. OfficeTemplateLibrary is the suggested type for Office files and will show up in the UI of all Office desktop apps and Office online in the templates section.
 
 ```yaml
 Type: OrgAssetType
 Parameter Sets: (All)
-Accepted values: ImageDocumentLibrary, OfficeTemplateLibrary
+Accepted values: ImageDocumentLibrary, OfficeTemplateLibrary, BrandColorsList, BrandFontsLibrary, BrandKitLibrary, OfficeFontLibrary, Undefined
 
 Required: False
 Position: Named
@@ -163,4 +163,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/Get-PnPFileCheckedOut.md

@@ -0,0 +1,68 @@
+---
+Module Name: PnP.PowerShell
+title: Get-PnPFileCheckedOut
+schema: 2.0.0
+applicable: SharePoint Online
+external help file: PnP.PowerShell.dll-Help.xml
+online version: https://pnp.github.io/powershell/cmdlets/Get-PnPFileCheckedOut.html
+---
+
+# Get-PnPFileCheckedOut
+
+## SYNOPSIS
+Returns all files that are currently checked out in a library
+
+## SYNTAX
+
+```powershell
+Get-PnPFileCheckedOut -List <ListPipeBind> [-Connection <PnPConnection>] 
+```
+
+## DESCRIPTION
+
+This cmdlet allows to retrieve all files that are currently checked out in a library.
+
+Notice: if this cmdlet would return more then 5,000 results, so 5,000 or more checked out files, it will not work and will throw an error. This is unfortunately a limitation of SharePoint Online and not something that can be fixed in the cmdlet. As long as the number of checked out files is below 5,000, this cmdlet will work as expected, even on document libraries that contain more than 5,000 files.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Get-PnPFileCheckedOut -List "Documents"
+```
+
+Returns all files that are currently checked out in the "Documents" library.
+
+## 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
+```
+
+### -List
+The list instance, list display name, list url or list id to query for checked out files
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: True
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

documentation/Get-PnPTenantPronounsSetting.md

@@ -0,0 +1,57 @@
+---
+Module Name: PnP.PowerShell
+schema: 2.0.0
+applicable: SharePoint Online
+online version: https://pnp.github.io/powershell/cmdlets/Get-PnPTenantPronounsSetting.html
+external help file: PnP.PowerShell.dll-Help.xml
+title: Get-PnPTenantPronounsSetting
+---
+
+# Get-PnPTenantPronounsSetting
+
+## SYNOPSIS
+
+**Required Permissions**
+
+  * Microsoft Graph API : One of PeopleSettings.Read.All, PeopleSettings.ReadWrite.All
+
+Retrieve the current setting for the availability of using pronouns in the organization
+
+## SYNTAX
+
+```powershell
+Get-PnPTenantPronounsSetting [-Connection <PnPConnection>] 
+```
+
+## DESCRIPTION
+
+This cmdlet can be used to retrieve tenant wide pronounsSettings properties.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Get-PnPTenantPronounsSetting
+```
+
+Retrieves the tenant-wide pronouns settings
+
+## 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](Get-PnPConnection.md).
+
+```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)
+[Microsoft Graph documentation](https://learn.microsoft.com/graph/api/peopleadminsettings-list-pronouns)

documentation/Set-PnPSite.md

@@ -16,10 +16,11 @@ Sets site collection properties.
 
 ### Set Properties
 ```powershell
-Set-PnPSite [-Identity <String>]
-[-Classification <String>]
-[-DisableFlows]
-[-LogoFilePath <String>]
+Set-PnPSite 
+ [-Identity <String>]
+ [-Classification <String>]
+ [-DisableFlows]
+ [-LogoFilePath <String>]
  [-Sharing <SharingCapabilities>]
  [-StorageMaximumLevel <Int64>]
  [-StorageWarningLevel <Int64>]
@@ -49,6 +50,9 @@ Set-PnPSite [-Identity <String>]
  [-ListsShowHeaderAndNavigation <Boolean>]
  [-RestrictContentOrgWideSearch <Boolean>]
  [-CanSyncHubSitePermissions <SwitchParameter>]
+ [-HidePeoplePreviewingFiles <Boolean>]
+ [-HidePeopleWhoHaveListsOpen <Boolean>]
+ [-RestrictedAccessControl <Boolean>]
  [-Connection <PnPConnection>]
 ```
 
@@ -326,6 +330,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -HidePeopleWhoHaveListsOpen
+Allows hiding of the presence indicators of users simultaneously working in lists.
+
+```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.