From 194e08fe6e4b8cbd4d93c47dddd178b99657e17e Mon Sep 17 00:00:00 2001
From: reshmee011 <reshmee011@gmail.com>
Date: Tue, 23 Jul 2024 08:37:35 +0100
Subject: [PATCH 1/3] Add example to get sharing link from list item

---
 documentation/Get-PnPFileSharingLink.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/documentation/Get-PnPFileSharingLink.md b/documentation/Get-PnPFileSharingLink.md
index 02a2c32cf..4be26d674 100644
--- a/documentation/Get-PnPFileSharingLink.md
+++ b/documentation/Get-PnPFileSharingLink.md
@@ -10,7 +10,7 @@ title: Get-PnPFileSharingLink
 # Get-PnPFileSharingLink
 
 ## SYNOPSIS
-Retrieves sharing links to associated with the file.
+Retrieves sharing links to associated with the file or list item.
 
 ## SYNTAX
 
@@ -20,7 +20,7 @@ Get-PnPFileSharingLink -Identity <FilePipeBind> [-Verbose] [-Connection <PnPConn
 
 ## DESCRIPTION
 
-Retrieves sharing links for a file.
+Retrieves sharing links for a file or list item.
 
 ## EXAMPLES
 
@@ -46,6 +46,7 @@ Get-PnPListItem -List "Documents" | Get-PnPFileSharingLink
 This will fetch sharing links for all files in the `Documents` library.
 
 ### EXAMPLE 4
+
 ```powershell
 Get-PnPListItem -List "Documents" -Id 1 | Get-PnPFileSharingLink
 ```
@@ -73,6 +74,13 @@ Get-PnPFileInFolder -Recurse -ExcludeSystemFolders -FolderSiteRelativeUrl "Share
 
 This will fetch sharing links for all files in the `Shared Documents` library, including the files in subfolders, excluding the ones in hidden internal system folders where no expiration has been set on the sharing of the file.
 
+### EXAMPLE 8
+```powershell	
+Get-PnPFileSharingLink -Identity /sites/demo/Lists/Issue tracker/1_.000
+```
+
+This will fetch sharing links for the list item with id `1` from list `Issue Tracker`
+
 ## PARAMETERS
 
 ### -Connection

From 56d9219375a815e4754e61b0224cf7f6dc2b82f6 Mon Sep 17 00:00:00 2001
From: reshmee011 <reshmee011@gmail.com>
Date: Mon, 7 Oct 2024 23:14:43 +0100
Subject: [PATCH 2/3] new cmdlet to remove rss

---
 ...ve-PnPTenantRestrictedSearchAllowedList.md | 109 ++++++++++++++++++
 ...RemoveTenantRestrictedSearchAllowedList.cs |  75 ++++++++++++
 2 files changed, 184 insertions(+)
 create mode 100644 documentation/Remove-PnPTenantRestrictedSearchAllowedList.md
 create mode 100644 src/Commands/Admin/RemoveTenantRestrictedSearchAllowedList.cs

diff --git a/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md b/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md
new file mode 100644
index 000000000..fb7a187db
--- /dev/null
+++ b/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md
@@ -0,0 +1,109 @@
+---
+Module Name: PnP.PowerShell
+schema: 2.0.0
+applicable: SharePoint Online
+online version: https://pnp.github.io/powershell/cmdlets/Remove-PnPTenantRestrictedSearchAllowedList.html
+external help file: PnP.PowerShell.dll-Help.xml
+title: Remove-PnPTenantRestrictedSearchAllowedList
+---
+  
+# Remove-PnPTenantRestrictedSearchAllowedList
+
+## SYNOPSIS
+Removes site URLs from the allowed list when Restricted SharePoint Search is enabled. The URLs can be provided as a string array or read from a CSV file.
+
+## SYNTAX
+
+```powershell
+Remove-PnPTenantRestrictedSearchAllowedList [-SitesListFileUrl <String>] [-SitesList <String[]>] [-ContainsHeaders <SwitchParameter>] [-Connection <PnPConnection>] 
+```
+
+## DESCRIPTION
+
+Removes site URLs from the allowed list when Restricted SharePoint Search is enabled. The URLs can be provided directly as a string array or read from a CSV file. At present, a maximum of 100 sites can be added to the allowed list.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Remove-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.csv" -ContainsHeader
+```
+
+Removes site URLs from the allowed list from a CSV file. The first line, which is assumed to be a header, is skipped.
+
+### EXAMPLE 2
+```powershell
+Remove-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.csv" 
+```
+
+Removes site URLs from the allowed list from a CSV file.
+
+### EXAMPLE 3
+```powershell
+Remove-PnPTenantRestrictedSearchAllowedList -SitesList @("https://contoso.sharepoint.com/sites/Company311","https://contoso.sharepoint.com/sites/contosoportal")
+```
+Removes the specified sites from the allowed list.
+
+## 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
+```
+
+### -SitesListFileUrl
+Specifies the path of the CSV file that contains a list of site URLs to be removed from the allowed list when the tenant is set to Restricted Tenant Search Mode.
+
+```yaml
+Type: String
+Parameter Sets: File
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SitesList
+Specifies a collection of sites to remove from the allowed list.
+
+```yaml
+Type: String[]
+Parameter Sets: SiteList
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Containsheader
+
+If specified, this switch skips the first line from the CSV file, which is assumed to be a header.
+
+```yaml
+Type: SwitchParamter
+Parameter Sets: File
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+## RELATED LINKS
+
+[How does Restricted SharePoint Search work?](https://learn.microsoft.com/sharepoint/restricted-sharepoint-search)
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)
diff --git a/src/Commands/Admin/RemoveTenantRestrictedSearchAllowedList.cs b/src/Commands/Admin/RemoveTenantRestrictedSearchAllowedList.cs
new file mode 100644
index 000000000..99086756d
--- /dev/null
+++ b/src/Commands/Admin/RemoveTenantRestrictedSearchAllowedList.cs
@@ -0,0 +1,75 @@
+using Microsoft.Online.SharePoint.TenantAdministration;
+using Microsoft.SharePoint.Client;
+using PnP.PowerShell.Commands.Base;
+using System.Collections.Generic;
+using System.Management.Automation;
+using System.Linq;
+using System;
+
+namespace PnP.PowerShell.Commands.Admin
+{
+    [Cmdlet(VerbsCommon.Remove, "PnPTenantRestrictedSearchAllowedList", DefaultParameterSetName = ParameterSet_SiteList)]
+    public class RemoveTenantRestrictedSearchAllowedList : PnPAdminCmdlet
+    {
+        private const string ParameterSet_SiteList = "SiteList";
+        private const string ParameterSet_File = "File";
+
+        [Parameter(Mandatory = true, ParameterSetName = ParameterSet_SiteList)]
+        public string[] SitesList;
+
+        [Parameter(Mandatory = true, ParameterSetName = ParameterSet_File)]
+        public string SitesListFileUrl;
+
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_File)]
+        public SwitchParameter ContainsHeader;
+
+        protected override void ExecuteCmdlet()
+        {
+            IList<string> _sitelist = null;
+            if (ParameterSetName == ParameterSet_File)
+            {
+                _sitelist = ReadFileContents();
+            }
+            else if (ParameterSetName == ParameterSet_SiteList)
+            {
+                _sitelist = SitesList;
+            }
+            else
+            {
+                throw new ArgumentException("Parameter set cannot be resolved using the specified named parameters.");
+            }
+
+            if (_sitelist == null)
+            {
+                throw new InvalidOperationException("SiteList cannot be null");
+            }
+
+            if(_sitelist.Count > 100)
+            {
+                WriteWarning($"The maximum number of sites that can be added to the allowed list is 100. You have specified {_sitelist.Count} sites. Will try to add them anyway.");
+            }
+
+            Tenant.RemoveSPORestrictedSearchAllowedList(_sitelist);
+            AdminContext.ExecuteQueryRetry();
+        }
+
+        private IList<string> ReadFileContents()
+        {
+            var lines = System.IO.File.ReadAllLines(SitesListFileUrl);
+            if (ContainsHeader)
+            {
+                lines = lines.Skip(1).ToArray();
+            }
+
+            foreach (var line in lines)
+            {
+                if (line.Contains(','))
+                {
+                    throw new InvalidOperationException("File should only contain one column and no commas");
+                }
+            }
+
+            return lines.ToList();
+        }
+    }
+}
\ No newline at end of file

From dae5c0c7e064c5a829b3d29d52de1103f2a49254 Mon Sep 17 00:00:00 2001
From: reshmee011 <reshmee011@gmail.com>
Date: Thu, 10 Oct 2024 22:21:13 +0100
Subject: [PATCH 3/3] add csv sample data

---
 .../Add-PnPTenantRestrictedSearchAllowedList.md  | 16 ++++++++++++++++
 ...emove-PnPTenantRestrictedSearchAllowedList.md | 15 +++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/documentation/Add-PnPTenantRestrictedSearchAllowedList.md b/documentation/Add-PnPTenantRestrictedSearchAllowedList.md
index 1e68222d3..51ca61d07 100644
--- a/documentation/Add-PnPTenantRestrictedSearchAllowedList.md
+++ b/documentation/Add-PnPTenantRestrictedSearchAllowedList.md
@@ -31,6 +31,14 @@ Add-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.csv
 
 Adds site URLs to the allowed list from a CSV file. The first line, which is assumed to be a header, is skipped.
 
+Sample CSV file content:
+
+```csv
+SiteUrl
+https://contoso.sharepoint.com/sites/Company311
+https://contoso.sharepoint.com/sites/contosoportal
+```
+
 ### EXAMPLE 2
 ```powershell
 Add-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.csv" 
@@ -38,10 +46,18 @@ Add-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.csv
 
 Adds site URLs to the allowed list from a CSV file.
 
+Sample CSV file content:
+
+```csv
+https://contoso.sharepoint.com/sites/Company311
+https://contoso.sharepoint.com/sites/contosoportal
+```
+
 ### EXAMPLE 3
 ```powershell
 Add-PnPTenantRestrictedSearchAllowedList -SitesList @("https://contoso.sharepoint.com/sites/Company311","https://contoso.sharepoint.com/sites/contosoportal")
 ```
+
 Adds the specified sites to the allowed list.
 
 ## PARAMETERS
diff --git a/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md b/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md
index fb7a187db..20a80dbd5 100644
--- a/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md
+++ b/documentation/Remove-PnPTenantRestrictedSearchAllowedList.md
@@ -31,6 +31,14 @@ Remove-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.
 
 Removes site URLs from the allowed list from a CSV file. The first line, which is assumed to be a header, is skipped.
 
+Sample CSV file content:
+
+```csv
+SiteUrl
+https://contoso.sharepoint.com/sites/Company311
+https://contoso.sharepoint.com/sites/contosoportal
+```
+
 ### EXAMPLE 2
 ```powershell
 Remove-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.csv" 
@@ -38,6 +46,13 @@ Remove-PnPTenantRestrictedSearchAllowedList -SitesListFileUrl "C:\temp\sitelist.
 
 Removes site URLs from the allowed list from a CSV file.
 
+Sample CSV file content:
+
+```csv
+https://contoso.sharepoint.com/sites/Company311
+https://contoso.sharepoint.com/sites/contosoportal
+```
+
 ### EXAMPLE 3
 ```powershell
 Remove-PnPTenantRestrictedSearchAllowedList -SitesList @("https://contoso.sharepoint.com/sites/Company311","https://contoso.sharepoint.com/sites/contosoportal")