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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplication.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplication.md index a7d0ad8e0..38bfb2ec5 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] diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOContainerTypeConfiguration.md index ede3af46a..ebe86e7ef 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: --- @@ -22,13 +22,15 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId [-DiscoverabilityDisab [-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 @@ -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 @@ -106,6 +115,131 @@ 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 +``` + ### -WhoCanShareAnonymousAllowList @@ -183,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`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters). + ## RELATED LINKS [Get-SPOContainerTypeConfiguration](Get-SPOContainerTypeConfiguration.md)