Skip to content

Commit 349dfaf

Browse files
KoenZomersKoenZomers
authored
Merge pull request #3802 from KoenZomers/master
Master
2 parents c215d5d + 5d65bcb commit 349dfaf

File tree

154 files changed

+10564
-15382
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

154 files changed

+10564
-15382
lines changed

‎.github/workflows/builddocsite.yml

+4-4
Original file line numberDiff line numberDiff line change
@@ -13,22 +13,22 @@ jobs:
1313
env:
1414
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
1515
- name: Checkout master branch
16-
uses: actions/checkout@v3
16+
uses: actions/checkout@v4
1717
with:
1818
ref: master
1919
path: master
2020
- name: Checkout dev branch
21-
uses: actions/checkout@v3
21+
uses: actions/checkout@v4
2222
with:
2323
ref: dev
2424
path: dev
2525
- name: Checkout gh-pages branch
26-
uses: actions/checkout@v3
26+
uses: actions/checkout@v4
2727
with:
2828
ref: gh-pages
2929
path: gh-pages
3030
- name: Setup .NET 7.0
31-
uses: actions/setup-dotnet@v3
31+
uses: actions/setup-dotnet@v4
3232
with:
3333
dotnet-version: 7.x
3434

‎.github/workflows/buildexternalhelp.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ jobs:
1313
runs-on: ubuntu-latest
1414

1515
steps:
16-
- uses: actions/checkout@v3
16+
- uses: actions/checkout@v4
1717
- name: Building Help File
1818
env:
1919
RUNSINACTION: 1

‎.github/workflows/buildpr.yml

+4-4
Original file line numberDiff line numberDiff line change
@@ -17,23 +17,23 @@ jobs:
1717
runs-on: ubuntu-latest
1818
steps:
1919
- name: Checkout PnP.Framework
20-
uses: actions/checkout@v3
20+
uses: actions/checkout@v4
2121
with:
2222
repository: pnp/pnpframework
2323
path: pnpframework
2424
ref: 'dev'
2525
- name: Checkout PnP.Core
26-
uses: actions/checkout@v3
26+
uses: actions/checkout@v4
2727
with:
2828
repository: pnp/pnpcore
2929
path: pnpcore
3030
ref: 'dev'
3131
- name: Checkout PnP.PowerShell
32-
uses: actions/checkout@v3
32+
uses: actions/checkout@v4
3333
with:
3434
path: powershell
3535
- name: Setup .NET Core
36-
uses: actions/setup-dotnet@v3
36+
uses: actions/setup-dotnet@v4
3737
with:
3838
dotnet-version: |
3939
6.0.x

‎.github/workflows/checkdocumentationbuild.yml

+4-4
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,20 @@ jobs:
1212

1313
runs-on: ubuntu-latest
1414
steps:
15-
- uses: actions/checkout@v3
15+
- uses: actions/checkout@v4
1616
with:
1717
ref: master
1818
path: master
19-
- uses: actions/checkout@v3
19+
- uses: actions/checkout@v4
2020
with:
2121
ref: dev
2222
path: dev
23-
- uses: actions/checkout@v3
23+
- uses: actions/checkout@v4
2424
with:
2525
ref: gh-pages
2626
path: gh-pages
2727
- name: Setup .NET 7.0
28-
uses: actions/setup-dotnet@v3
28+
uses: actions/setup-dotnet@v4
2929
with:
3030
dotnet-version: 7.x
3131

‎.github/workflows/cleanupnightlyreleases.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ jobs:
1414
# Steps represent a sequence of tasks that will be executed as part of the job
1515
steps:
1616
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
17-
- uses: actions/checkout@v3
17+
- uses: actions/checkout@v4
1818
with:
1919
ref: dev
2020
- name: Setup .NET 6.0
21-
uses: actions/setup-dotnet@v3
21+
uses: actions/setup-dotnet@v4
2222
with:
2323
dotnet-version: '6.0.x'
2424
- name: Unlist nightly nuget packages

‎.github/workflows/nightlyrelease.yml

+5-5
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,12 @@ jobs:
1111

1212
steps:
1313
- name: Setup .NET Core
14-
uses: actions/setup-dotnet@v3
14+
uses: actions/setup-dotnet@v4
1515
with:
1616
dotnet-version: |
1717
6.x
1818
7.x
19-
- uses: actions/checkout@v3
19+
- uses: actions/checkout@v4
2020
with:
2121
ref: dev
2222
token: ${{ secrets.PAT }}
@@ -41,7 +41,7 @@ jobs:
4141
runs-on: windows-2022
4242
needs: [ build ]
4343
steps:
44-
- uses: actions/checkout@v3
44+
- uses: actions/checkout@v4
4545
- name: Build an image
4646
run: |
4747
$VERSION="$(cat ./version.txt)-nightly"
@@ -55,7 +55,7 @@ jobs:
5555
runs-on: windows-2019
5656
needs: [ build ]
5757
steps:
58-
- uses: actions/checkout@v3
58+
- uses: actions/checkout@v4
5959
- name: Build an image
6060
run: |
6161
$VERSION="$(cat ./version.txt)-nightly"
@@ -69,7 +69,7 @@ jobs:
6969
runs-on: ubuntu-latest
7070
needs: [ build ]
7171
steps:
72-
- uses: actions/checkout@v3
72+
- uses: actions/checkout@v4
7373
- name: Build an image
7474
run: |
7575
VERSION=$(cat ./version.txt)-nightly

‎.github/workflows/release.yml

+3-3
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ jobs:
88
publish-docker-windows-2022:
99
runs-on: windows-2022
1010
steps:
11-
- uses: actions/checkout@v3
11+
- uses: actions/checkout@v4
1212
- name: Build and Publish All
1313
shell: pwsh
1414
run: |
@@ -17,7 +17,7 @@ jobs:
1717
publish-docker-windows-2019:
1818
runs-on: windows-2019
1919
steps:
20-
- uses: actions/checkout@v3
20+
- uses: actions/checkout@v4
2121
- name: Build and Publish All
2222
shell: pwsh
2323
run: |
@@ -26,7 +26,7 @@ jobs:
2626
publish-docker-linux:
2727
runs-on: ubuntu-latest
2828
steps:
29-
- uses: actions/checkout@v3
29+
- uses: actions/checkout@v4
3030
- name: Build and Publish All
3131
shell: pwsh
3232
run: |

‎CHANGELOG.md

+69-2
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,74 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
1010

1111
### Added
1212

13+
- Added `-IsDataAccessInCardDesignerEnabled` to `Set-PnPTenant` which allows for configuring Viva Connections Adaptive Cards to connect to backend services for their data [#3635](https://github.com/pnp/powershell/pull/3635)
14+
- Added `Remove-PnPContainer` cmdlet to remove the SharePoint embed container. [#3629](https://github.com/pnp/powershell/pull/3629)
15+
- 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)
16+
- Added `Merge-PnPTerm` cmdlet which allows merging of one term into another. [#3638](https://github.com/pnp/powershell/pull/3638)
17+
- Added `Get-PnPDeletedContainer` cmdlet which returns a list of all deleted Containers in the recycle bin. [#3648](https://github.com/pnp/powershell/pull/3648)
18+
- 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)
19+
- Added `Get-PnPContainerTypeConfiguration` cmdlet which fetches the container type configuration values. [#3660](https://github.com/pnp/powershell/pull/3660)
20+
- Added `-AppBypassInformationBarriers` and `-DefaultOneDriveInformationBarrierMode` parameters to `Set-PnPTenant` cmdlet. [#3679](https://github.com/pnp/powershell/pull/3679)
21+
- Added `Add-PnPFileAnalyticsData` cmdlet to allow retrieval of file analytics data. [#3644](https://github.com/pnp/powershell/pull/3644)
22+
- Added `Add-PnPSiteAnalyticsData` cmdlet to allow retrieval of site analytics data. [#3645](https://github.com/pnp/powershell/pull/3645)
23+
- Added `Get-PnPPowerPlatformSolution` cmdlet to Power Platform solutions. [#3675](https://github.com/pnp/powershell/pull/3675)
24+
- Added `New-PnPContainerType` cmdlet to create a new SharePoint container type. [#3669](https://github.com/pnp/powershell/pull/3669)
25+
- Added `Remove-PnPContainerType` cmdlet which removes a specific container type. [#3689](https://github.com/pnp/powershell/pull/3689/)
26+
- Added `Restore-PnPDeletedContainer` cmdlet which recovers a deleted Container from the Recycle Bin. [#3661](https://github.com/pnp/powershell/pull/3661)
27+
- Added the ModerationSettings to be returned with `Get-PnPTeamsChannel` when passing in `-IncludeModerationSettings` and using `-Identity <channelId>` [#3580](https://github.com/pnp/powershell/pull/3580)
28+
- Added `AllowNewMessageFromBots`, `AllowNewMessageFromConnectors`, `ReplyRestriction` and `UserNewMessageRestriction` to `Set-PnPTeamsChannel` which allows setting the moderation settings on a Teams channel [#3580](https://github.com/pnp/powershell/pull/3580)
29+
- Added `Get-PnPWebPermission` cmdlet which retrieves permission given by user for specific web. [#3685](https://github.com/pnp/powershell/pull/3685)
30+
- Added `-HorizontalQuickLaunch` parameter to `Set-PnPWeb` cmdlet to allow navigation orientation to be horizontal. [#3722](https://github.com/pnp/powershell/pull/3722)
31+
- Added support for different sovereign cloud environment for Power Platform related cmdlets [#3725](https://github.com/pnp/powershell/pull/3725)
32+
- Added `Set-PnPRetentionLabel` and `Reset-PnPRetentionLabel` cmdlets to support setting a retention label on one or more items [#3599](https://github.com/pnp/powershell/pull/3599)
33+
- Added `-SiteThumbnailUrl` parameter to `Set-PnPWebHeader` cmmdlet to support setting thumbnail of the site. [#3746](https://github.com/pnp/powershell/pull/3746)
34+
- Added `-Like` parameter to `Set-PnPPage` cmdlet to support liking/unliking a modern page. [#3788](https://github.com/pnp/powershell/pull/3788)
35+
- Added `Get-PnPPageLikedByInformation` cmdlet to retrieve list of users who liked a modern page. [#3781](https://github.com/pnp/powershell/pull/3781)
36+
37+
### Fixed
38+
39+
- Fixed `Grant-PnPAzureADAppSitePermission` cmdlet which allows it to work in multi-geo environment. [#3658](https://github.com/pnp/powershell/pull/3658)
40+
- Fixed `Get-PnPTeamsChannelMessageReply` cmdlet which didn't work correctly when `-IncludeDeleted` parameter was not specified. [#3676](https://github.com/pnp/powershell/pull/3676)
41+
- Fixed `Add-PnPNavigationNode` cmdlet to also search for nodes in child navigation items. [#3625](https://github.com/pnp/powershell/pull/3625)
42+
- Fixed `Get-PnPFlow` cmdlet to use the newer Flow URLs instead of the old ARM URLs. [#3677](https://github.com/pnp/powershell/pull/3677)
43+
- 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)
44+
- Fixed `Add-PnPHubSiteAssociation` cmdlet to allow support for multi-geo scenario. [#3568](https://github.com/pnp/powershell/pull/3568)
45+
- Fixed `Enable/Disable-PnPPageScheduling` cmdlet to also work with Viva connections enabled site. [#3713](https://github.com/pnp/powershell/pull/3713)
46+
- Fixed `Register-PnPManagementShellAccess` and `Register-PnPAzureADApp` cmdlets to also work with custom environment. [#3763](https://github.com/pnp/powershell/pull/3763)
47+
- Fixed `Set-PnPPPage` cmdlet to only change layout of the page if the parameter is specified. [#3777](https://github.com/pnp/powershell/pull/3777)
48+
- Fixed `New-PnPGroup` cmdlet to correctly show the group description with HTML making it similar to `Set-PnPGroup`.
49+
50+
### Changed
51+
52+
- `-IsFavoriteByDefault` parameter is now obsolete in `Add-PnPTeamsChannel` cmdlet due to deprecation by Microsoft Graph API. [#3712](https://github.com/pnp/powershell/pull/3712)
53+
- `Get-PnPSiteTemplate` will now only contain `PersistPublishingFiles`, `IncludeNativePublishingFiles`, `IncludeTermGroupsSecurity`, `IncludeSearchConfiguration`, `SkipVersionCheck` and `PersistMultiLanguageResources` if these are provided with the cmdlet as switch parameters [#3715](https://github.com/pnp/powershell/pull/3715)
54+
- Due to backend changes in Microsoft Graph, `Get-PnPUnifiedAuditLog` cmdlet requires some more permissions. Updated the cmdlet to handle that. [#3745](https://github.com/pnp/powershell/pull/3745)
55+
56+
### Contributors
57+
58+
- Arleta Wanat [PowershellScripts]
59+
- Jenny Wu [msjennywu]
60+
- Aimery Thomas [a1mery]
61+
- Nils Andresen [nils-a]
62+
- Gautam Sheth [gautamdsheth]
63+
- Nishkalank Bezawada [NishkalankBezawada]
64+
- Konrad K. [wilecoyotegenius]
65+
- Leon Armston [LeonArmston]
66+
- Daniel Cecil [danielcecil]
67+
- Rohit Devmore [rohit404404]
68+
- Konrad K. [wilecoyotegenius]
69+
- Kunj Balkrishna Sangani [kunj-sangani]
70+
- Koen Zomers [koenzomers]
71+
- Reshmee Auckloo [reshme011]
72+
- Nishkalank Bezawada [NishkalankBezawada]
73+
- Jørgen Wiik [joHKwi]
74+
- Siddharth Vaghasia [siddharth-vaghasia]
75+
- Jürgen Rosenthal-Buroh [JuergenRB]
76+
77+
## [2.3.0]
78+
79+
### Added
80+
1381
- Added `-MediaTranscription` and `-MediaTranscriptionAutomaticFeatures` to `Set-PnPTenant` which allows for configuring the media transcription settings. [#3238](https://github.com/pnp/powershell/pull/3238)
1482
- Added `-Includes` option to `Get-PnPListItem` which allows for specifying additional fields to be retrieved. [#3270](https://github.com/pnp/powershell/pull/3270)
1583
- Added `-AllowCommentsTextOnEmailEnabled` parameter to `Set-PnPTenant` which allows including the surrounding document context in email notification when user is mentioned in document comments. [#3268](https://github.com/pnp/powershell/pull/3268)
@@ -50,6 +118,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
50118
- Added support for executing the 'Invoke-PnPSPRestMethod' cmdlet in a batch [#3565](https://github.com/pnp/powershell/pull/3565)
51119
- Added `Get-PnPSiteSetVersionPolicyProgress` cmdlet which allows for getting the progress of setting a version policy for existing document libraries on a site [#3564](https://github.com/pnp/powershell/pull/3564)
52120
- Added `EnableSensitivityLabelForPDF` to `Set-PnPTenant` and `Get-PnPTenant` [#3581](https://github.com/pnp/powershell/pull/3581)
121+
- Changed `Restore-PnPRecycleBinItem` , made `-Identity` parameter as non-mandatory. [#2499](https://github.com/pnp/powershell/pull/2499)
53122
- Added the ability to set Manage and FullControl permissions directly when using Sites.Selected with `Grant-PnPAzureADAppSitePermission` [#3617](https://github.com/pnp/powershell/pull/3617)
54123
- Added `Remove-PnPMicrosoft365GroupPhoto` cmdlet which allows removal of profile picture of M365 Group. [#3607](https://github.com/pnp/powershell/pull/3607)
55124

@@ -105,7 +174,6 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
105174
- Antti K. Koskela [koskila]
106175
- Christian Veenhuis [ChVeen]
107176
- Kunj Balkrishna Sangani [kunj-sangani]
108-
- Antti K. Koskela [koskila]
109177
- Dave Paylor [paylord]
110178
- [smsdaniel]
111179
- Jim Duncan [sparkitect]
@@ -406,7 +474,6 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
406474
- Improved `Remove-PnPFieldFromContentType` cmdlet to ensure proper null check for non-existing fields. It will now throw proper `Field not found` error. [#2407](https://github.com/pnp/powershell/pull/2407)
407475
- Changed the Microsoft 365 Groups cmdlets to use the `v1.0` endpoint instead of the `beta` [#2426](https://github.com/pnp/powershell/pull/2426)
408476
- Changed `Add-PnPMicrosoft365GroupToSite` to longer require the `-Url` parameter to be specified. If its not provided, the currently connected to site will be groupified. [#2496](https://github.com/pnp/powershell/pull/2496)
409-
- Changed `Restore-PnPRecycleBinItem` , made `-Identity` parameter as non-mandatory. [#2499](https://github.com/pnp/powershell/pull/2499)
410477

411478
### Removed
412479

‎MIGRATE-2.0-to-3.0.md

+57
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Updating from PnP PowerShell 2.x to 3.x
2+
3+
_This is a draft document, version 3 is not yet available_
4+
5+
The 3.x version of PnP PowerShell is based exclusively on .NET 8.0, which means that it will not work on older PowerShell editions like PowerShell 5.1, ISE or PowerShell 7.3 or older. PowerShell 7.4 or later is required.
6+
7+
- The 3.x version of PnP PowerShell will work only on PowerShell 7.4 or later versions.
8+
9+
## Steps to update from 2.x to 3.x
10+
11+
- Download and install the latest PowerShell version from [this GitHub releases link](https://aka.ms/powershell-release?tag=lts)
12+
13+
Or
14+
15+
- For Windows environments, please use [this link](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows)
16+
17+
- For Linux based environments, please use [this link](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux)
18+
19+
- For Mac OS envoronments, please use [this link](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-macos)
20+
21+
Once the PowerShell 7.4 or later is downloaded and installed in the environment, you can install the PnP PowerShell module like you normally do.
22+
23+
```powershell
24+
Install-Module -Name "PnP.PowerShell"
25+
```
26+
27+
If you want to install or update to the latest nightly built prerelease of PnP PowerShell, run:
28+
29+
```powershell
30+
Install-Module -Name "PnP.PowerShell" -AllowPrerelease
31+
```
32+
33+
## Changes needed in Azure DevOps/GitHub Actions/Pipelines
34+
35+
If you are using PnP PowerShell in Azure Devops, GitHub Actions or other pipeline infrastructure, you will have to update your PowerShell version from v5 to v7.4 or later.
36+
37+
Recommend referring to these 2 links:
38+
39+
- [DevOps Snack: Change PowerShell version in YAML](https://microsoft-bitools.blogspot.com/2021/02/devops-snack-change-powershell-version.html)
40+
- [How to enable PowerShell core in Azure Pipeline?](https://theautomationcode.com/how-to-enable-powershell-core-in-azure-pipeline/)
41+
42+
## Breaking changes
43+
44+
| **Cmdlet** | **Comment** |
45+
| ----------- | ---------------------- |
46+
| Get-PnPRetentionLabel | The `Get-PnPRetentionLabel` cmdlet has been renamed to `Get-PnPTenantRetentionLabel` |
47+
| Get-PnPLabel | The `Get-PnPLabel` cmdlet has been renamed to `Get-PnRetentionLabel` |
48+
| Get-PnPPowerPlatformConnector | The `Get-PnPPowerPlatformConnector` cmdlet has been renamed to `Get-PnPPowerPlatformCustomConnector` |
49+
| Connect-PnPOnline | Using `Connect-PnPOnline` without specifying an authentication option will now default to using an interactive login. If you still want to use logon using client credentials, provide them using -Credentials instead |
50+
51+
## Other notable changes
52+
53+
- ...
54+
55+
## Changes to output type
56+
57+
- ...

‎build/Build-Nightly.ps1

+1-1
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@ if ($runPublish -eq $true) {
174174
}
175175

176176
# Generate predictor commands
177-
./build/Generate-PredictorCommands.ps1 -Version $version
177+
./build/Generate-PredictorCommands.ps1 -Version "nightly"
178178

179179
Write-Host "Generating Documentation" -ForegroundColor Yellow
180180
Set-PSRepository PSGallery -InstallationPolicy Trusted

‎documentation/Add-PnPGroupMember.md

+29
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,12 @@ Add-PnPGroupMember -Group <GroupPipeBind> -EmailAddress <String> [-SendEmail] [-
2626
[-Connection <PnPConnection>]
2727
```
2828

29+
### Batched
30+
```powershell
31+
Add-PnPGroupMember -LoginName <String> -Group <GroupPipeBind>
32+
[-Connection <PnPConnection>] -Batch <PnPBatch>
33+
```
34+
2935
## DESCRIPTION
3036

3137
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 [email protected] -Group 5
4652

4753
Add the specified user to the SharePoint group with Id 5
4854

55+
### EXAMPLE 3
56+
```powershell
57+
$batch = New-PnPBatch
58+
Add-PnPGroupMember -LoginName [email protected] -Group 5 -Batch $batch
59+
Add-PnPGroupMember -LoginName [email protected] -Group 5 -Batch $batch
60+
Invoke-PnPBatch $batch
61+
```
62+
63+
Add the specified users to the SharePoint group with Id 5 in a batch.
64+
4965
## PARAMETERS
5066

5167
### -Connection
@@ -130,6 +146,19 @@ Accept pipeline input: False
130146
Accept wildcard characters: False
131147
```
132148
149+
### -Batch
150+
151+
```yaml
152+
Type: PnPBatch
153+
Parameter Sets: Batched
154+
155+
Required: True
156+
Position: Named
157+
Default value: None
158+
Accept pipeline input: False
159+
Accept wildcard characters: False
160+
```
161+
133162
134163
135164
## RELATED LINKS

0 commit comments

Comments
 (0)