Merge branch 'dev' into dev

CHANGELOG.md

@@ -11,9 +11,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 ### Added
 
 - Added `-MediaTranscription` and `-MediaTranscriptionAutomaticFeatures` to `Set-PnPTenant` which allows for configuring the media transcription settings. [#3238](https://github.com/pnp/powershell/pull/3238)
-- 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)
+- Added `-Includes` option to `Get-PnPListItem` which allows for specifying additional fields to be retrieved. [#3270](https://github.com/pnp/powershell/pull/3270)
+- 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)
 - Added `Export-PnPPowerApp` cmdlet which will export a specified PowerApp as zip package. [#2990](https://github.com/pnp/powershell/pull/2990)
 - Added `AzureADLoginEndPoint` and `MicrosoftGraphEndPoint` parameters to `Connect-PnPOnline` cmdlet for use in custom Azure environments. [#2925](https://github.com/pnp/powershell/pull/2925)
+- Added `-SharingStatus` parameter to `Get-PnPFlow` which allows for filtering flows based on their sharing status. [#3287](https://github.com/pnp/powershell/pull/3287)
+- Added `-AzureADLoginEndPoint` and `-MicrosoftGraphEndPoint` parameters to `Connect-PnPOnline` cmdlet for use in custom Azure environments. [#2925](https://github.com/pnp/powershell/pull/2925)
 
 ### Fixed
 
@@ -25,9 +28,20 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Fixed `New-PnPSite` cmdlet issue with team site creation when using a connection object. [#3285](https://github.com/pnp/powershell/pull/3285)
 - Fixed issue with colliding assemblies when using PnP PowerShell with other modules. [#3280](https://github.com/pnp/powershell/pull/3280)
 - Fixed issue with `-ArchiveRedirectUrl` parameter not working correctly in `Set-PnPTenant` cmdlet. [#3289](https://github.com/pnp/powershell/pull/3289)
+- Fixed `New-PnPAzureADGroup` cmdlet throwing null reference error when owners and members are not specified. [#3308](https://github.com/pnp/powershell/pull/3308)
+- Fixed `New-PnPTeamsTeam` cmdlet, it will now throw error if it fails to teamify a Microsoft 365 group. [#3310](https://github.com/pnp/powershell/pull/3310)
+- Fixed `Connect-PnPOnline` cmdlet throwing host not reachable errors. [#3337](https://github.com/pnp/powershell/pull/3337)
+- Fixed `Set-PnPTerm` cmdlet throwing object reference error when only the term Id is specified. [#3341](https://github.com/pnp/powershell/pull/3341)
+
+### Changed
+
+- Improved `Set-PnPListItem` cmdlet handling of Purview labels. [#3340](https://github.com/pnp/powershell/pull/3340)
 
 ### Contributors
 
+- Per Østergaard [per-oestergaard]
+- Nishkalank Bezawada [NishkalankBezawada]
+- [PowerBugi]
 - Ganesh Sanap [ganesh-sanap]
 - Siddharth Vaghasia [siddharth-vaghasia]
 - Giacomo Pozzoni [jackpoz]

MIGRATE-1.0-to-2.0.md

@@ -57,7 +57,7 @@ Using PnP PowerShell in Azure functions ? You might be required to change the Pn
 | ----------- | ---------------------- | -------------------- | --------------------- |
 | New-PnPTenantSite | Force | - | The parameter was obsolete and not used. It has been removed. |
 | Set-PnPTenantSite | BlockDownloadOfNonViewableFiles | AllowDownloadingNonWebViewableFiles | The parameter was obsolete and hence removed. Use `AllowDownloadingNonWebViewableFiles` |
-| Connect-PnPOnline | NoTelemetry | - | The parameter was obsolete and hence removed. Use `$env:PNP_DISABLETELEMETRY` environment variable or `Disable-PnPTelemetry/Enable-PnPTelemetry` cmdlet |
+| Connect-PnPOnline | NoTelemetry | - | The parameter was obsolete and hence removed. Use `$env:PNPPOWERSHELL_DISABLETELEMETRY` environment variable or `Disable-PnPTelemetry/Enable-PnPTelemetry` cmdlet |
 | Connect-PnPOnline | NoVersionCheck | - | The parameter was obsolete and hence removed. Use `$env:PNPPOWERSHELL_UPDATECHECK` environment variable |
 | Disconnect-PnPOnline | Connection | - | The parameter was obsolete and hence removed. |
 | Request-PnPAccessToken | Resource | Scopes | The parameter was obsolete and hence removed. Use `Scopes` instead |
@@ -90,4 +90,4 @@ Using PnP PowerShell in Azure functions ? You might be required to change the Pn
 - The output type of `Get-PnPAzureADGroupMember` has changed to `PnP.PowerShell.Commands.Model.Microsoft365User`
 - The output type of `Get-PnPAzureADGroup` has changed to `PnP.PowerShell.Commands.Model.Graph.Group`
 - The output type of `New-PnPAzureADGroup` has changed to `PnP.PowerShell.Commands.Model.Graph.Group`
-- The output type of `Get-PnPUserProfileProperty` has changed to `SortedDictionary<string, object>`
+- The output type of `Get-PnPUserProfileProperty` has changed to `SortedDictionary<string, object>`

documentation/Find-PnPFile.md

@@ -103,7 +103,7 @@ Accept wildcard characters: False
 ```
 
 ### -Match
-Wildcard query
+Wildcard query using * (any number of charactes) and ? (single character)
 
 ```yaml
 Type: String
@@ -113,7 +113,7 @@ Required: True
 Position: 0
 Default value: None
 Accept pipeline input: True (ByValue)
-Accept wildcard characters: False
+Accept wildcard characters: True
 ```
 
 

documentation/Get-PnPAzureACSPrincipal.md

@@ -25,6 +25,8 @@ Get-PnPAzureACSPrincipal [-Scope <AzureACSPrincipalScope>] [-IncludeSubsites <Sw
 
 ## DESCRIPTION
 
+This cmdlet provides insight into the app registrations that have been done over time using AppRegNew.aspx. You could look at it as a (detailed) equivallent of AppPrincipals.aspx. This information can help to get insights into the app registrations that have been done on a tenant and prepare for the Azure Access Control Services (ACS) deprecation that will follow in the future.
+
 ## EXAMPLES
 
 ### EXAMPLE 1

documentation/Get-PnPFile.md

@@ -16,25 +16,27 @@ Downloads a file
 
 ### Return as file object (Default)
 ```powershell
-Get-PnPFile [-Url] <String> -AsFileObject [-Connection <PnPConnection>]
- 
+Get-PnPFile -Url <String> -AsFileObject [-Connection <PnPConnection>]
 ```
 
 ### Return as list item
 ```powershell
-Get-PnPFile [-Url] <String> -AsListItem [-ThrowExceptionIfFileNotFound] 
- [-Connection <PnPConnection>] 
+Get-PnPFile -Url <String> -AsListItem [-ThrowExceptionIfFileNotFound] [-Connection <PnPConnection>] 
 ```
 
 ### Save to local path
 ```powershell
-Get-PnPFile [-Url] <String> -AsFile [-Path <String>] [-Filename <String>] [-Force] 
- [-Connection <PnPConnection>] 
+Get-PnPFile -Url <String> -AsFile -Path <String> -Filename <String> [-Force] [-Connection <PnPConnection>] 
 ```
 
 ### Return as string
 ```powershell
-Get-PnPFile [-Url] <String> -AsString [-Connection <PnPConnection>] 
+Get-PnPFile -Url <String> -AsString [-Connection <PnPConnection>] 
+```
+
+### Return as memorystream
+```powershell
+Get-PnPFile -Url <String> -AsMemoryStream [-Connection <PnPConnection>] 
 ```
 
 ## DESCRIPTION

documentation/Get-PnPFlow.md

@@ -15,31 +15,48 @@ title: Get-PnPFlow
 
 * Azure: management.azure.com
 
-Returns the flows for a given environment
+Returns Power Automate Flows
 
 ## SYNTAX
 
+### All (Default)
 ```powershell
-Get-PnPFlow [-Environment <PowerAutomateEnvironmentPipeBind>] [-AsAdmin] [-Identity <PowerPlatformPipeBind>] 
-[-Connection <PnPConnection>] [-Verbose]
+Get-PnPFlow [-Environment <PowerAutomateEnvironmentPipeBind>] [-AsAdmin] [-SharingStatus <FlowSharingStatus>] [-Connection <PnPConnection>] [-Verbose]
+```
+
+### By Identity
+```powershell
+Get-PnPFlow [-Environment <PowerAutomateEnvironmentPipeBind>] [-AsAdmin] [-Identity <PowerPlatformPipeBind>] [-Connection <PnPConnection>] [-Verbose]
 ```
 
 ## DESCRIPTION
-This cmdlet returns the flows for a given environment.
+This cmdlet returns Power Automate Flows meeting the specified criteria.
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-Get-PnPPowerPlatformEnvironment -Identity "MyOrganization (default)" | Get-PnPFlow
+Get-PnPFlow -AsAdmin
 ```
-This returns all the flows for a given Power Platform environment
+Returns all the flows in the default Power Platform environment belonging to any user
 
 ### Example 2
 ```powershell
+Get-PnPPowerPlatformEnvironment -Identity "MyOrganization (default)" | Get-PnPFlow
+```
+Returns all the flows for a given Power Platform environment belonging to the current user
+
+### Example 3
+```powershell
+Get-PnPFlow -SharingStatus SharedWithMe
+```
+Returns all the flows which have been shared with the current user in the default Power Platform environment
+
+### Example 4
+```powershell
 Get-PnPFlow -Identity fba63225-baf9-4d76-86a1-1b42c917a182
 ```
-This returns a specific flow from the default environment
+Returns a specific flow from the default Power Platform environment
 
 ## PARAMETERS
 
@@ -63,7 +80,7 @@ The Name/Id of the flow to retrieve.
 
 ```yaml
 Type: PowerPlatformPipeBind
-Parameter Sets: (All)
+Parameter Sets: By Identity
 Aliases:
 
 Required: False
@@ -104,6 +121,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -SharingStatus
+Allows specifying the type of Power Automate Flows that should be returned. Valid values: All, SharedWithMe, Personal.
+
+```yaml
+Type: FlowSharingStatus
+Parameter Sets: All
+
+Required: False
+Position: Named
+Default value: All
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Verbose
 When provided, additional debug statements will be shown while executing the cmdlet.
 

documentation/Submit-PnPTeamsChannelMessage.md

@@ -13,7 +13,7 @@ online version: https://pnp.github.io/powershell/cmdlets/Submit-PnPTeamsChannelM
 
 **Required Permissions**
 
-  * Microsoft Graph API: API required one of 'Teamwork.Migrate.All, ChannelMessage.ReadWrite.All'.
+  * Microsoft Graph API: API required one of: `Teamwork.Migrate.All, ChannelMessage.Send or Group.ReadWrite.All`.
 
 Sends a message to a Microsoft Teams Channel.
 

pnpframework_hash.txt

@@ -1 +1 @@
-68a74deb61639d98cf3573b73aec2531fe31367f
+3dfef0d44df853b5bf4ad4390ce6b3fee0f10d92

pnppowershell_hash.txt

@@ -1 +1 @@
-d90091873176a477cb70a321d177d0a8190ba63a
+9aee231f630906ac884c417351a102fb5743ef05