Merge pull request #4488 from NishkalankBezawada/feature/AddWarnings-to-PowerAutomate-Commandlets

Added RequiredPermissionWarnings to 4 different commandlets

Author: KoenZomers

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/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

src/Commands/Lists/GetListItem.cs

@@ -4,13 +4,23 @@
 using System.Text;
 using System.Xml.Linq;
 using Microsoft.SharePoint.Client;
-
+using PnP.PowerShell.Commands.Attributes;
 using PnP.PowerShell.Commands.Base.PipeBinds;
 
 namespace PnP.PowerShell.Commands.Lists
 {
     [Cmdlet(VerbsCommon.Get, "PnPListItem", DefaultParameterSetName = ParameterSet_ALLITEMS)]
     [OutputType(typeof(ListItem))]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.Selected")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.Read.All")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.ReadWrite.All")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.Manage.All")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.FullControl.All")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.Read")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.Write")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.Manage")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.FullControl")]
+
     public class GetListItem : PnPWebRetrievalsCmdlet<ListItem>
     {
         private const string ParameterSet_BYID = "By Id";

src/Commands/PowerPlatform/PowerAutomate/GetDeletedFlow.cs

@@ -4,10 +4,12 @@
 using System.Linq;
 using System.Management.Automation;
 using PnP.PowerShell.Commands.Utilities;
+using PnP.PowerShell.Commands.Attributes;
 
 namespace PnP.PowerShell.Commands.PowerPlatform.PowerAutomate
 {
     [Cmdlet(VerbsCommon.Get, "PnPDeletedFlow", DefaultParameterSetName = ParameterSet_ALL)]
+    [RequiredApiDelegatedPermissions("azure/user_impersonation")]
     public class GetDeletedFlow : PnPAzureManagementApiCmdlet
     {
         private const string ParameterSet_ALL = "All";

src/Commands/Purview/GetAvailableSensitivityLabel.cs

@@ -1,4 +1,5 @@
-using PnP.PowerShell.Commands.Base;
+using PnP.PowerShell.Commands.Attributes;
+using PnP.PowerShell.Commands.Base;
 using PnP.PowerShell.Commands.Base.PipeBinds;
 using PnP.PowerShell.Commands.Utilities.REST;
 using System;
@@ -10,6 +11,8 @@ namespace PnP.PowerShell.Commands.Purview
     [Cmdlet(VerbsCommon.Get, "PnPAvailableSensitivityLabel")]
     [OutputType(typeof(IEnumerable<Model.Graph.Purview.InformationProtectionLabel>))]
     [OutputType(typeof(Model.Graph.Purview.InformationProtectionLabel))]
+    [RequiredApiApplicationPermissions("graph/InformationProtectionPolicy.ReadAll")]
+    [RequiredApiDelegatedPermissions("graph/InformationProtectionPolicy.Read")]
     public class GetAvailableSensitivityLabel : PnPGraphCmdlet
     {
         [Parameter(Mandatory = false)]

src/Commands/Site/GetSite.cs

@@ -1,10 +1,22 @@
-using Microsoft.SharePoint.Client;
+using Microsoft.SharePoint.Client;
+using PnP.PowerShell.Commands.Attributes;
+using System;
+using System.Linq.Expressions;
 using System.Management.Automation;
 
 namespace PnP.PowerShell.Commands.Site
 {
     [Cmdlet(VerbsCommon.Get, "PnPSite")]
     [OutputType(typeof(Microsoft.SharePoint.Client.Site))]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.Selected")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.Read.All")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.ReadWrite.All")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.Manage.All")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.FullControl.All")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.Read")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.Write")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.Manage")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.FullControl")] 
     public class GetSite : PnPRetrievalsCmdlet<Microsoft.SharePoint.Client.Site>
     {
         protected override void ExecuteCmdlet()

src/Commands/Site/GetSiteVersionPolicy.cs

@@ -1,14 +1,14 @@
 using Microsoft.SharePoint.Client;
-
-using System;
-using System.Linq.Expressions;
 using System.Management.Automation;
 using PnP.PowerShell.Commands.Model.SharePoint;
+using PnP.PowerShell.Commands.Attributes;
 
 namespace PnP.PowerShell.Commands.Site
 {
     [Cmdlet(VerbsCommon.Get, "PnPSiteVersionPolicy")]
-    [OutputType(typeof(PnP.PowerShell.Commands.Model.SharePoint.SiteVersionPolicy))]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.FullControl")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.FullControl.All")]
+    [OutputType(typeof(SiteVersionPolicy))]
     public class GetSiteVersionPolicy : PnPSharePointCmdlet
     {
         protected override void ExecuteCmdlet()

src/Commands/Site/SetSiteVersionPolicy.cs

@@ -1,13 +1,12 @@
 using Microsoft.SharePoint.Client;
-
-using System;
-using System.Linq.Expressions;
 using System.Management.Automation;
-using PnP.PowerShell.Commands.Model.SharePoint;
+using PnP.PowerShell.Commands.Attributes;
 
 namespace PnP.PowerShell.Commands.Site
 {
     [Cmdlet(VerbsCommon.Set, "PnPSiteVersionPolicy")]
+    [RequiredApiDelegatedPermissions("sharepoint/AllSites.FullControl")]
+    [RequiredApiApplicationPermissions("sharepoint/Sites.FullControl.All")]
     [OutputType(typeof(void))]
     public class SetSiteVersionPolicy : PnPSharePointCmdlet
     {