From 9901adf5452f7bc33477c2223b69359a8eba1477 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Mon, 5 May 2025 15:29:33 -0700 Subject: [PATCH 1/8] Update Set-SPOApplication.md --- .../sharepoint-ps/sharepoint-online/Set-SPOApplication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplication.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplication.md index 98b67e74c..14161f0fd 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplication.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplication.md @@ -83,7 +83,7 @@ This example sets the host URLs for the application with Id 423poi45. ### -CopilotEmbeddedChatHosts -This parameter is used to add host URLs allowed to use the SharePoint Embedded application's declarative agent experience. +This parameter is used to add host URLs allowed to use the SharePoint Embedded application's declarative agent experience. This will always be a subset of permissible URLs set by the application's developer. To check the list of permissible URLs, use the `Get-SPOApplication` cmdlet. ```yaml Type: System.Collections.Generic.List`1[System.String] From 92696d466debf9aa4d7961219c563140419a5466 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Mon, 5 May 2025 15:40:52 -0700 Subject: [PATCH 2/8] Update Get-SPOContainerTypeConfiguration.md --- .../Get-SPOContainerTypeConfiguration.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOContainerTypeConfiguration.md index 5845c153b..f0046307f 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOContainerTypeConfiguration.md @@ -14,21 +14,21 @@ ms.reviewer: ## SYNOPSIS -Returns container type configurations in a SharePoint Embedded application. +Use this cmdlet to read the configuration values set on the container type. ## SYNTAX ### ParamSet1 ```powershell -Get-SPOContainerTypeConfiguration [-ContainerTypeId ] +Get-SPOContainerTypeConfiguration -ContainerTypeId [] ``` ## DESCRIPTION -The `Get-SPOContainerTypeConfiguration` cmdlet retrieves and returns configuration settings set on a container type created under a SharePoint Embedded application. +The `Get-SPOContainerTypeConfiguration` cmdlet retrieves and returns configuration settings set on a container type created under a SharePoint Embedded application. This can either be the default value or the previously set value on the container type. -You must be a SharePoint Administrator or Global Administrator to run this cmdlet. +You must be a SharePoint Embedded Administrator to run this cmdlet. ## EXAMPLES @@ -58,6 +58,10 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +### CommonParameters + +This cmdlet supports the common parameters: `-Debug`, `-ErrorAction`, `-ErrorVariable`, `-InformationAction`, `-InformationVariable`, `-OutVariable`, `-OutBuffer`, `-PipelineVariable`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters). + ## RELATED LINKS From 3e3eb1e68bdc59024bc5f31b04d6a2889a3699e0 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Mon, 5 May 2025 15:57:27 -0700 Subject: [PATCH 3/8] Update Set-SPOContainerTypeConfiguration.md --- .../Set-SPOContainerTypeConfiguration.md | 149 +++++++++++++++++- 1 file changed, 145 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index 8e41e3c9b..081503d7b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md @@ -5,8 +5,8 @@ online version: https://learn.microsoft.com/powershell/module/sharepoint-online/ applicable: SharePoint Online title: Set-SPOContainerTypeConfiguration schema: 2.0.0 -author: FarreltinF -ms.author: fanyi +author: ShreyasSar26 +ms.author: shsaravanan ms.reviewer: --- @@ -18,14 +18,19 @@ Sets or updates the configuration settings of a container type in SharePoint Emb ## SYNTAX ```powershell -Set-SPOContainerTypeConfiguration [-ContainerTypeId ] [-DiscoverabilityDisabled ] [-SharingRestricted ] +Set-SPOContainerTypeConfiguration -ContainerTypeId [-DiscoverabilityDisabled ] + [-SharingRestricted ] [-ApplicationRedirectUrl ] [-WhoCanShareAnonymousAllowList ] + [-WhoCanShareAuthenticatedGuestAllowList ] [-OverrideTenantWhoCanShareAnonymousAllowList ] + [-OverrideTenantWhoCanShareAuthenticatedGuestAllowList ] + [[-CopilotEmbeddedChatHosts] ] [-WhatIf] [-Confirm] + [] ``` ## DESCRIPTION For any parameters passed in, the `Set-SPOContainerTypeConfiguration` cmdlet sets or updates the settings for a container type created under a SharePoint Embedded application. -You must be a SharePoint Administrator or Global Administrator to run this cmdlet. +You must be a SharePoint Embedded Administrator to run this cmdlet. ## EXAMPLES @@ -45,6 +50,13 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb Example 2 turns on an open sharing model for this container type. Any container members and guest users with edit permissions can share files created within the container type. +### Example 3 + +```powershell +Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585 -CopilotEmbeddedChatHosts "http://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com" +``` +This example sets the host URLs for the container type with Id 4f0af585. + ## PARAMETERS ### -DiscoverabilityDisabled @@ -79,6 +91,135 @@ Default value: True Accept pipeline input: False Accept wildcard characters: False ``` +### -ApplicationRedirectUrl + +This parameter specifies the url of that the application should be redirected to. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ContainerTypeId + +This parameter specifies the ID of the container type corresponding to the SharePoint Embedded application. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CopilotEmbeddedChatHosts +This parameter is used to add host URLs allowed to use the SharePoint Embedded application's declarative agent experience. + +```yaml +Type: System.Collections.Generic.List`1[System.String] +Parameter Sets: (All) +Aliases: + +Required: False +Position: 3 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + + +### -OverrideTenantWhoCanShareAnonymousAllowList + +This setting determines if the container type `WhoCanShareAnonymousAllowList` overrides the tenant-level `WhoCanShareAnonymousAllowList`. The default value for this parameter is false. + +PARAMVALUE: True | False + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -OverrideTenantWhoCanShareAuthenticatedGuestAllowList + +This setting determines if the container type `WhoCanShareAuthenticatedGuestAllowList` overrides the tenant-level `WhoCanShareAuthenticatedGuestAllowList`. The default value for this parameter is false. + +PARAMVALUE: True | False + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhoCanShareAnonymousAllowList + +Sets a container type-specific list of security groups who are allowed to share with anonymous (non-authenticated) users as well as authenticated guest users. This must be set in conjunction with `OverrideTenantWhoCanShareAnonymousAllowList`. + +> [!NOTE] +> This allow list only accepts security groups, and not Microsoft 365 Groups. + +Each security group is denoted by its GUID object ID. To set this list to be a specific security group, you need to enter its GUID as the parameter. You can enter multiple GUIDs by using a comma to separate them. To skip the check and allow all security groups to share to anyone, set this allow list and the `WhoCanShareAuthenticatedGuestAllowList` to null arrays. + +```yaml +Type: Guid[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhoCanShareAuthenticatedGuestAllowList + +Sets a container type-specific list of security groups who are allowed to share with authenticated guest users at the container level. This must be set in conjunction with `OverrideTenantWhoCanShareAuthenticatedGuestAllowList`. + +> [!NOTE] +> This allow list only accepts security groups, and not Microsoft 365 Groups. + +Each security group is denoted by its GUID object ID. To set this list to be a specific security group, you need to enter its GUID as the parameter. You can enter multiple GUIDs by using a comma to separate them. To skip the check and allow all security groups to share to authenticated guests, set this allow list to a null array. + + +```yaml +Type: Guid[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## RELATED LINKS From 7a7f50a4f1665388c1544bcde1747893756c3f51 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Tue, 6 May 2025 11:09:06 -0700 Subject: [PATCH 4/8] Update Set-SPOContainerTypeConfiguration.md --- .../Set-SPOContainerTypeConfiguration.md | 25 ------------------- 1 file changed, 25 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index 081503d7b..8fd340ba4 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md @@ -22,8 +22,6 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId [-DiscoverabilityDisab [-SharingRestricted ] [-ApplicationRedirectUrl ] [-WhoCanShareAnonymousAllowList ] [-WhoCanShareAuthenticatedGuestAllowList ] [-OverrideTenantWhoCanShareAnonymousAllowList ] [-OverrideTenantWhoCanShareAuthenticatedGuestAllowList ] - [[-CopilotEmbeddedChatHosts] ] [-WhatIf] [-Confirm] - [] ``` ## DESCRIPTION @@ -50,12 +48,6 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb Example 2 turns on an open sharing model for this container type. Any container members and guest users with edit permissions can share files created within the container type. -### Example 3 - -```powershell -Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585 -CopilotEmbeddedChatHosts "http://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com" -``` -This example sets the host URLs for the container type with Id 4f0af585. ## PARAMETERS @@ -123,21 +115,6 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -CopilotEmbeddedChatHosts -This parameter is used to add host URLs allowed to use the SharePoint Embedded application's declarative agent experience. - -```yaml -Type: System.Collections.Generic.List`1[System.String] -Parameter Sets: (All) -Aliases: - -Required: False -Position: 3 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - ### -OverrideTenantWhoCanShareAnonymousAllowList @@ -218,8 +195,6 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## RELATED LINKS From e55e10c90ec4814d19eabea62e8cf55256f1a1e0 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Tue, 6 May 2025 11:10:29 -0700 Subject: [PATCH 5/8] Update Set-SPOContainerTypeConfiguration.md --- .../Set-SPOContainerTypeConfiguration.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index 8fd340ba4..a2ce91a07 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md @@ -48,6 +48,30 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb Example 2 turns on an open sharing model for this container type. Any container members and guest users with edit permissions can share files created within the container type. +### Example 3 + +```powershell +Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true -WhoCanShareAnonymousAllowList +``` + +Example 3 overrides the tenant-level `WhoCanShareAnonymousAllowList`. + +### Example 4 + +```powershell +Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true –WhoCanShareAnonymousAllowList $null -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null +``` + +Example 4 overrides the tenant-level `WhoCanShareAnonymousAllowList` and `WhoCanShareAuthenticatedGuestAllowList` with null values, which bypass the check. This has the effect of no longer restricting external sharing privileges to members of specific security groups. + +### Example 5 + +```powershell +Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null +``` + +Example 5 overrides the tenant-level `WhoCanShareAuthenticatedGuestAllowList` with a null value, while leaving the `WhoCanShareAnonymousAllowList` untouched. This has the effect of no longer restricting the privilege of sharing to authenticated guests to members of specific security groups. +>>>>>>> main ## PARAMETERS From f2a94675ae2deac08c19bf61662ca21461b53921 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Tue, 6 May 2025 11:11:14 -0700 Subject: [PATCH 6/8] Update Set-SPOContainerTypeConfiguration.md --- .../sharepoint-online/Set-SPOContainerTypeConfiguration.md | 1 - 1 file changed, 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index a2ce91a07..216e7cc11 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md @@ -71,7 +71,6 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb ``` Example 5 overrides the tenant-level `WhoCanShareAuthenticatedGuestAllowList` with a null value, while leaving the `WhoCanShareAnonymousAllowList` untouched. This has the effect of no longer restricting the privilege of sharing to authenticated guests to members of specific security groups. ->>>>>>> main ## PARAMETERS From 776f647eb1719c874eea4114b76b911e603b8ea8 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Tue, 6 May 2025 11:20:36 -0700 Subject: [PATCH 7/8] Update Set-SPOContainerTypeConfiguration.md --- .../Set-SPOContainerTypeConfiguration.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index 5d100f85c..297478ad1 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md @@ -22,6 +22,8 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId [-DiscoverabilityDisab [-SharingRestricted ] [-ApplicationRedirectUrl ] [-WhoCanShareAnonymousAllowList ] [-WhoCanShareAuthenticatedGuestAllowList ] [-OverrideTenantWhoCanShareAnonymousAllowList ] [-OverrideTenantWhoCanShareAuthenticatedGuestAllowList ] + [[-CopilotEmbeddedChatHosts] ] [-WhatIf] [-Confirm] + [] ``` ## DESCRIPTION @@ -72,6 +74,13 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb Example 5 overrides the tenant-level `WhoCanShareAuthenticatedGuestAllowList` with a null value, while leaving the `WhoCanShareAnonymousAllowList` untouched. This has the effect of no longer restricting the privilege of sharing to authenticated guests to members of specific security groups. +### Example 6 + +```powershell +Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585 -CopilotEmbeddedChatHosts "http://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com" +``` +This example sets the host URLs for the container type with Id 4f0af585. + ## PARAMETERS ### -DiscoverabilityDisabled @@ -137,7 +146,20 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +### -CopilotEmbeddedChatHosts +This parameter is used to add host URLs allowed to use the SharePoint Embedded application's declarative agent experience. + +```yaml +Type: System.Collections.Generic.List`1[System.String] +Parameter Sets: (All) +Aliases: +Required: False +Position: 3 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` ### -OverrideTenantWhoCanShareAnonymousAllowList @@ -295,6 +317,9 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + ## RELATED LINKS [Get-SPOContainerTypeConfiguration](Get-SPOContainerTypeConfiguration.md) From 03b06c6d48fec8e5a60e62125feb1404653d0054 Mon Sep 17 00:00:00 2001 From: ShreyasSar26 <136049061+ShreyasSar26@users.noreply.github.com> Date: Sun, 11 May 2025 20:21:20 -0700 Subject: [PATCH 8/8] Update sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md Co-authored-by: Sam M. Kabue --- .../sharepoint-online/Set-SPOContainerTypeConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index 297478ad1..ebe86e7ef 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md @@ -318,7 +318,7 @@ Accept wildcard characters: False ``` ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). +This cmdlet supports the common parameters: `-Debug`, `-ErrorAction`, `-ErrorVariable`, `-InformationAction`, `-InformationVariable`, `-OutVariable`, `-OutBuffer`, `-PipelineVariable`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters). ## RELATED LINKS