From 23d0f0ca3ad744cbd4b5269bfa62df4cd7034f91 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Fri, 25 Jul 2025 14:10:38 +0530 Subject: [PATCH 1/6] Update Set-SPOContainer.md --- .../Set-SPOContainer.md | 41 ++++++++++++++++++- 1 file changed, 39 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md index 7c10d7a19..4b1672f06 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md @@ -49,10 +49,18 @@ Set-SPOContainer [-Identity] [-SharingDomainRestrictionMode ] [-SharingAllowedDomainList ] [-SharingBlockedDomainList ] [-WhatIf] [-Confirm] [] ``` - +### PrincipalOwnerTransfer +``` +Set-SPOContainer [-Identity] -ExistingPrincipalOwner + -NewPrincipalOwner [-WhatIf] [-Confirm] [] + ``` ## DESCRIPTION -For any parameters that are passed in, the `Set-SPOContainer` cmdlet sets or updates the setting for the active container identified by the parameter `Identity`. The cmdlet throws an error if the identity of an archived container is provided. +For any parameters that are passed in, the `Set-SPOContainer` cmdlet sets or updates the setting for the active container identified by the parameter `Identity`. The cmdlet throws an error if the identity of an archived container is provided. The principal owner transfer operation is supported only for containers that are user-owned. Attempting to perform this operation on containers that are tenant-owned or group-owned will result in an error. + +> [!IMPORTANT] +> Always wait for the current principal owner transfer attempt to finish before reusing the cmdlet. Concurrent or premature reuse can lead to incomplete or invalid ownership changes. +> You must be a SharePoint Embedded Administrator to run the cmdlet. @@ -182,6 +190,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ExistingPrincipalOwner +The current principal owner of the container. + +```yaml +Type: String +Parameter Sets: PrincipalOwnerTransfer +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Identity Use this parameter to specify the container url. @@ -220,6 +243,20 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -NewPrincipalOwner +The new user to whom a user-owned container's lifecycle will be tied to. +```yaml +Type: String +Parameter Sets: PrincipalOwnerTransfer +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ReadOnlyForBlockDownloadPolicy Controls if read-only should be enabled for block download policy. From 99edaf6d42b797931c45a16d99190a2366fc1400 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Mon, 4 Aug 2025 21:49:01 +0530 Subject: [PATCH 2/6] Update Set-SPOContainer.md --- .../Set-SPOContainer.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md index 4b1672f06..f3271c1ff 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md @@ -51,12 +51,12 @@ Set-SPOContainer [-Identity] ``` ### PrincipalOwnerTransfer ``` -Set-SPOContainer [-Identity] -ExistingPrincipalOwner +Set-SPOContainer [-Identity] -CurrentPrincipalOwner -NewPrincipalOwner [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION -For any parameters that are passed in, the `Set-SPOContainer` cmdlet sets or updates the setting for the active container identified by the parameter `Identity`. The cmdlet throws an error if the identity of an archived container is provided. The principal owner transfer operation is supported only for containers that are user-owned. Attempting to perform this operation on containers that are tenant-owned or group-owned will result in an error. +For any parameters that are passed in, the `Set-SPOContainer` cmdlet sets or updates the setting for the active container identified by the parameter `Identity`. The cmdlet throws an error if the identity of an archived container is provided. The principal owner transfer operation is supported only for containers that are user-owned. Attempting to perform this operation on non user-owned containers will result in an error. > [!IMPORTANT] > Always wait for the current principal owner transfer attempt to finish before reusing the cmdlet. Concurrent or premature reuse can lead to incomplete or invalid ownership changes. @@ -190,7 +190,7 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -ExistingPrincipalOwner +### -CurrentPrincipalOwner The current principal owner of the container. ```yaml From cbc2d8aa6cc8a9aba87556dfa1e88181f0043fa5 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Tue, 5 Aug 2025 10:12:35 +0530 Subject: [PATCH 3/6] Update Set-SPOContainer.md --- .../Set-SPOContainer.md | 51 +++++++++++++++++-- 1 file changed, 48 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md index f3271c1ff..090ca9ed3 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainer.md @@ -101,6 +101,8 @@ This example removes any previously set sensitivity label on the container. ### -AllowEditing +> Applicable: SharePoint Online + Prevents users from editing Office files in the browser and copying and pasting Office file contents out of the browser window. ```yaml @@ -117,6 +119,8 @@ Accept wildcard characters: False ### -AuthenticationContextName +> Applicable: SharePoint Online + The conditional access authentication context name. ```yaml @@ -133,7 +137,7 @@ Accept wildcard characters: False ### -BlockDownloadPolicy -> Applicable: SharePoint Embedded +> Applicable: SharePoint Online As a SharePoint Embedded Administrator, you can block the download of files from SharePoint Embedded containers. This feature does not need Microsoft Entra Conditional Access policies. This feature can be set for individual containers but not at the organization level. @@ -153,7 +157,7 @@ Accept wildcard characters: False ### -ConditionalAccessPolicy -> Applicable: SharePoint Embedded +> Applicable: SharePoint Online Read the [Control access from unmanaged devices](/sharepoint/control-access-from-unmanaged-devices) documentation to understand Conditional Access Policy usage in SharePoint Embedded container. @@ -176,6 +180,9 @@ Accept wildcard characters: False ``` ### -ExcludeBlockDownloadPolicyContainerOwners + +> Applicable: SharePoint Online + Controls if container owners are excluded from block download policy. ```yaml @@ -191,6 +198,9 @@ Accept wildcard characters: False ``` ### -CurrentPrincipalOwner + +> Applicable: SharePoint Online + The current principal owner of the container. ```yaml @@ -207,6 +217,8 @@ Accept wildcard characters: False ### -Identity +> Applicable: SharePoint Online + Use this parameter to specify the container url. ```yaml @@ -222,6 +234,9 @@ Accept wildcard characters: False ``` ### -LimitedAccessFileType + +> Applicable: SharePoint Online + The following parameters can be used with -ConditionalAccessPolicy AllowLimitedAccess for both the organization-wide setting and the container-level setting. OfficeOnlineFilesOnly: Allows users to preview only Office files in the browser. This option increases security but may be a barrier to user productivity. @@ -244,6 +259,9 @@ Accept wildcard characters: False ``` ### -NewPrincipalOwner + +> Applicable: SharePoint Online + The new user to whom a user-owned container's lifecycle will be tied to. ```yaml Type: String @@ -258,6 +276,9 @@ Accept wildcard characters: False ``` ### -ReadOnlyForBlockDownloadPolicy + +> Applicable: SharePoint Online + Controls if read-only should be enabled for block download policy. ```yaml @@ -273,6 +294,9 @@ Accept wildcard characters: False ``` ### -ReadOnlyForUnmanagedDevices + +> Applicable: SharePoint Online + Controls whether unmanaged devices have read-only access. ```yaml @@ -288,6 +312,9 @@ Accept wildcard characters: False ``` ### -RemoveLabel + +> Applicable: SharePoint Online + This parameter allows you to remove the assigned sensitivity label on a container. ```yaml @@ -303,7 +330,7 @@ Accept wildcard characters: False ### -SensitivityLabel -> Applicable: SharePoint Embedded +> Applicable: SharePoint Online Specifies the unique identifier (GUID) of the SensitivityLabel. @@ -320,6 +347,9 @@ Accept wildcard characters: False ``` ### -SharingAllowedDomainList + +> Applicable: SharePoint Online + Specifies a list of email domains that are allowed for sharing with the external collaborators. Use the space character as the delimiter for entering multiple values. For example, "contoso.com fabrikam.com". ```yaml @@ -335,6 +365,9 @@ Accept wildcard characters: False ``` ### -SharingBlockedDomainList + +> Applicable: SharePoint Online + Specifies a list of email domains that are blocked or prohibited for sharing with the external collaborators. Use space character as the delimiter for entering multiple values. For example, "contoso.com fabrikam.com". ```yaml @@ -350,6 +383,9 @@ Accept wildcard characters: False ``` ### -SharingDomainRestrictionMode + +> Applicable: SharePoint Online + Specifies the sharing mode for external domains. Possible values are: @@ -372,6 +408,9 @@ Accept wildcard characters: False ``` ### -Confirm + +> Applicable: SharePoint Online + Prompts you for confirmation before running the cmdlet. ```yaml @@ -387,6 +426,9 @@ Accept wildcard characters: False ``` ### -WhatIf + +> Applicable: SharePoint Online + Shows what would happen if the cmdlet runs. The cmdlet is not run. @@ -403,6 +445,9 @@ Accept wildcard characters: False ``` ### CommonParameters + +> Applicable: SharePoint Online + This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS From af1f8bb515d264d619df66a934f9555f33f49e44 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Tue, 5 Aug 2025 16:29:05 +0530 Subject: [PATCH 4/6] User permission report - support for emails --- .../Start-SPODataAccessGovernanceInsight.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Start-SPODataAccessGovernanceInsight.md index efae44886..666c84249 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Start-SPODataAccessGovernanceInsight.md @@ -53,7 +53,7 @@ Start-SPODataAccessGovernanceInsight -ReportEntity -Workload ### UserPermissionsParameterSet ``` Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType -Name -UserIDList + -ReportType -Name -UserEmailList [] ``` @@ -227,12 +227,12 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -UserIDList +### -UserEmailList -Specifies the Entra object IDs of the users for whom permissions report should be generated. Can be fetched using the `Get-MgUser` command from [Microsoft Graph PowerShell](/powershell/module/microsoft.graph.users/get-mguser). +Specifies the email IDs of the users for whom permissions report should be generated. ```yaml -Type: System.Collections.Generic.List`1[System.Guid] +Type: System.Collections.Generic.List`1[System.String] Parameter Sets: UserPermissionsParameterSet Aliases: From bff801a81fe489a320f596901a97320931b18458 Mon Sep 17 00:00:00 2001 From: AnithaTallam <75658826+AnithaTallam@users.noreply.github.com> Date: Tue, 5 Aug 2025 12:24:45 +0100 Subject: [PATCH 5/6] Adding isAuthoritative property --- .../Set-SPOSite.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index a6d4559a0..5918f9e91 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -63,6 +63,7 @@ Set-SPOSite [-Identity] [-Owner ] [-Title ] [- [-HidePeopleWhoHaveListsOpen ] [-AllowFileArchive ] [-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled ] [-DisableSiteBranding ] + [-IsAuthoritative ] [-WhatIf] [-Confirm] [] ``` @@ -1000,6 +1001,26 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -IsAuthoritative + +> Applicable: SharePoint Online + +When Admin with Copilot license mark the site as authoritative, it signals to Microsoft Search, Copilot(BizChat), and other AI agents that the content is official, trusted, and verified. This improves content discoverability and user trust in AI-generated responses. + +PARAMVALUE: True | False + +```yaml +Type: Boolean +Parameter Sets: ParamSet1 +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -EnableAutoExpirationVersionTrim > Applicable: SharePoint Online From 62c463623cedc2ba68187524401adbe66e1035d1 Mon Sep 17 00:00:00 2001 From: AnithaTallam <75658826+AnithaTallam@users.noreply.github.com> Date: Tue, 5 Aug 2025 17:33:55 +0100 Subject: [PATCH 6/6] Addressed PR comment --- .../Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index 5918f9e91..adb26af2a 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -1005,7 +1005,7 @@ Accept wildcard characters: False > Applicable: SharePoint Online -When Admin with Copilot license mark the site as authoritative, it signals to Microsoft Search, Copilot(BizChat), and other AI agents that the content is official, trusted, and verified. This improves content discoverability and user trust in AI-generated responses. +When an admin with a Copilot license marks a site as authoritative, it signals to Microsoft Search, Microsoft 365 Copilot, and other AI agents that the content is official, trusted, and verified. This designation helps improve content discoverability and increases user confidence in AI-generated responses. PARAMVALUE: True | False