-
Notifications
You must be signed in to change notification settings - Fork 347
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #3802 from KoenZomers/master
Master
- Loading branch information
Showing
154 changed files
with
10,564 additions
and
15,382 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
# Updating from PnP PowerShell 2.x to 3.x | ||
|
||
_This is a draft document, version 3 is not yet available_ | ||
|
||
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. | ||
|
||
- The 3.x version of PnP PowerShell will work only on PowerShell 7.4 or later versions. | ||
|
||
## Steps to update from 2.x to 3.x | ||
|
||
- Download and install the latest PowerShell version from [this GitHub releases link](https://aka.ms/powershell-release?tag=lts) | ||
|
||
Or | ||
|
||
- For Windows environments, please use [this link](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows) | ||
|
||
- For Linux based environments, please use [this link](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux) | ||
|
||
- For Mac OS envoronments, please use [this link](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-macos) | ||
|
||
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. | ||
|
||
```powershell | ||
Install-Module -Name "PnP.PowerShell" | ||
``` | ||
|
||
If you want to install or update to the latest nightly built prerelease of PnP PowerShell, run: | ||
|
||
```powershell | ||
Install-Module -Name "PnP.PowerShell" -AllowPrerelease | ||
``` | ||
|
||
## Changes needed in Azure DevOps/GitHub Actions/Pipelines | ||
|
||
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. | ||
|
||
Recommend referring to these 2 links: | ||
|
||
- [DevOps Snack: Change PowerShell version in YAML](https://microsoft-bitools.blogspot.com/2021/02/devops-snack-change-powershell-version.html) | ||
- [How to enable PowerShell core in Azure Pipeline?](https://theautomationcode.com/how-to-enable-powershell-core-in-azure-pipeline/) | ||
|
||
## Breaking changes | ||
|
||
| **Cmdlet** | **Comment** | | ||
| ----------- | ---------------------- | | ||
| Get-PnPRetentionLabel | The `Get-PnPRetentionLabel` cmdlet has been renamed to `Get-PnPTenantRetentionLabel` | | ||
| Get-PnPLabel | The `Get-PnPLabel` cmdlet has been renamed to `Get-PnRetentionLabel` | | ||
| Get-PnPPowerPlatformConnector | The `Get-PnPPowerPlatformConnector` cmdlet has been renamed to `Get-PnPPowerPlatformCustomConnector` | | ||
| 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 | | ||
|
||
## Other notable changes | ||
|
||
- ... | ||
|
||
## Changes to output type | ||
|
||
- ... |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -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 [email protected] -Group 5 | |
|
||
Add the specified user to the SharePoint group with Id 5 | ||
|
||
### EXAMPLE 3 | ||
```powershell | ||
$batch = New-PnPBatch | ||
Add-PnPGroupMember -LoginName [email protected] -Group 5 -Batch $batch | ||
Add-PnPGroupMember -LoginName [email protected] -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 | ||
|
Oops, something went wrong.