From 4d555c406535e16a40b86afc2f8da22e7896cfa8 Mon Sep 17 00:00:00 2001 From: bishalgautam-microsoft Date: Thu, 4 Sep 2025 14:27:13 +0100 Subject: [PATCH 1/5] Add documentation for IsAuthoritative site property filter --- .../Get-SPOSite.md | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md index e7e61be79..734b47dcf 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md @@ -236,7 +236,7 @@ Accept wildcard characters: False > Applicable: SharePoint Online Specifies the script block of the server-side filter to apply. The type must be a valid filter name and value must be in the form `{ PropertyName "filterValue"}`. Valid operators are as follows: -eq, -ne, -like, -notlike. - Currently, you can filter by these properties: Owner, Template (can be used to filter if it is the only property present in the filter), LockState, Url. + Currently, you can filter by these properties: Owner, Template (can be used to filter if it is the only property present in the filter), LockState, Url, IsAuthoritative (It only supports comparision operators -eq and -ne. For eg: `{IsAuthoritative -eq true}`). Using the -or operator to include an additional filter is not supported. Note: The operator values are case-sensitive. @@ -311,6 +311,24 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -IsAuthoritative + +> Applicable: SharePoint Online + +Displays sites which are have true value for IsAuthoritative site property when value is set to $true. The 'IsAuthoritaive' site property signals to Microsoft Search, Copilot(BizChat), and other AI agents that the site's content is official, trusted, and verified. This designation enhances content discoverability and increases user confidence in AI-generated responses. + +```yaml +Type: Boolean +Parameter Sets: ParamSet1 +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Limit > Applicable: SharePoint Online From ff413d8b6ccc67854b4a71445826f9e1bc4c8bd8 Mon Sep 17 00:00:00 2001 From: bishalgautam-microsoft Date: Thu, 4 Sep 2025 15:05:34 +0100 Subject: [PATCH 2/5] updated description of the filter --- .../Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md index 734b47dcf..a351c7c35 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md @@ -315,7 +315,7 @@ Accept wildcard characters: False > Applicable: SharePoint Online -Displays sites which are have true value for IsAuthoritative site property when value is set to $true. The 'IsAuthoritaive' site property signals to Microsoft Search, Copilot(BizChat), and other AI agents that the site's content is official, trusted, and verified. This designation enhances content discoverability and increases user confidence in AI-generated responses. +Filter the list of sites where the IsAuthoritative property is set to true. When IsAuthoritative is true, it signals to Microsoft Search, Copilot (BizChat), and other AI agents that the site's content is official, trusted, and verified. ```yaml Type: Boolean From 4bd74eee9e89cfadbecb4929710c9f0a6b525677 Mon Sep 17 00:00:00 2001 From: bishalgautam-microsoft Date: Fri, 5 Sep 2025 15:05:08 +0100 Subject: [PATCH 3/5] Example added and PR reviews addressed --- .../Get-SPOSite.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md index a351c7c35..fd5511a7f 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md @@ -125,13 +125,21 @@ This example uses server side filtering to return sites matching 18. ### EXAMPLE 8 +```powershell +Get-SPOSite -Filter { IsAuthoritative -eq true } +``` + +This example uses server side filtering to return Authoritative sites (i.e., sites that have the IsAuthoritative property set to true). + +### EXAMPLE 9 + ```powershell Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true} ``` This example uses client-side filtering to return a list of sites connected to Microsoft Teams. -### EXAMPLE 9 +### EXAMPLE 10 ```powershell Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true} @@ -139,14 +147,14 @@ Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true} This example uses client-side filtering to return a list of sites connected to a Microsoft Teams Private or Shared channel. -### EXAMPLE 10 +### EXAMPLE 11 ```powershell Get-SPOSite -Limit ALL -GroupIdDefined $true ``` This example uses server-side filtering to return all sites that have an associated Microsoft 365 Group. -### EXAMPLE 11 +### EXAMPLE 12 ```powershell $userUPN="joe.healy@contoso.com" @@ -236,7 +244,7 @@ Accept wildcard characters: False > Applicable: SharePoint Online Specifies the script block of the server-side filter to apply. The type must be a valid filter name and value must be in the form `{ PropertyName "filterValue"}`. Valid operators are as follows: -eq, -ne, -like, -notlike. - Currently, you can filter by these properties: Owner, Template (can be used to filter if it is the only property present in the filter), LockState, Url, IsAuthoritative (It only supports comparision operators -eq and -ne. For eg: `{IsAuthoritative -eq true}`). + Currently, you can filter by these properties: Owner, Template (can be used to filter if it is the only property present in the filter), LockState, Url, IsAuthoritative (only supports comparison operators -eq and -ne). Using the -or operator to include an additional filter is not supported. Note: The operator values are case-sensitive. From 396b3d5b1d1c63544ab19ab5e7ddc41d97ebf5fe Mon Sep 17 00:00:00 2001 From: bishalgautam-microsoft Date: Fri, 5 Sep 2025 15:23:51 +0100 Subject: [PATCH 4/5] Updated ParamSet1 as generated by New-MarkdownHelp command --- .../Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md index fd5511a7f..71f9d4f1f 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md @@ -20,7 +20,7 @@ Returns one or more site collections. ### ParamSet1 (Default) ``` -Get-SPOSite [[-Identity] ] [-Limit ] [-Detailed] [] +Get-SPOSite [[-Identity] ] [-Limit ] [-Detailed] [-IsAuthoritative ] [] ``` ### ParamSet3 From ec8e73e0209861b088b0e607cafb4a67bbab2337 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Fri, 5 Sep 2025 22:46:35 +0530 Subject: [PATCH 5/5] typo fix --- .../Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md index 71f9d4f1f..4ac69b88e 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSite.md @@ -111,7 +111,7 @@ This example gets quota details for a Group Site. Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment ``` -This example returns the InformationSegments associated with the site. It is applicable for tenants who have enabled Microsoft 365 Information barriers capability. Read [Learn about information barriers](/microsoft-365/compliance/information-barriers) to understand Information barriers in SharePoint Online. +This example returns the InformationSegment associated with the site. It is applicable for tenants who have enabled Microsoft 365 Information barriers capability. Read [Learn about information barriers](/microsoft-365/compliance/information-barriers) to understand Information barriers in SharePoint Online. **Note**: This property is available only in SharePoint Online Management Shell Version 16.0.19927.12000 or later.