Merge branch 'main' into patch-2

Author: Ruchika-mittal01

sharepoint/sharepoint-ps/sharepoint-online/Get-SPOApplication.md

@@ -5,8 +5,8 @@ online version: https://learn.microsoft.com/powershell/module/sharepoint-online/
 applicable: SharePoint
 title: Get-SPOApplication
 schema: 2.0.0
-author: cindylay
-ms.author: cindylay
+author: ShreyasSar26
+ms.author: shsaravanan
 ms.reviewer:
 ---
 
@@ -18,21 +18,35 @@ Returns a list of SharePoint Embedded applications in the specified tenant.
 
 ## SYNTAX
 
+```
+Get-SPOApplication [[-OwningApplicationId] <Guid>] [[-ApplicationId] <Guid>] [<CommonParameters>]
+```
+
 ### ParamSet1
 
 ```powershell
-Get-SPOApplication [[-OwningApplicationId] <OwningApplicationid>] [<CommonParameters>]
+Get-SPOApplication [<CommonParameters>]
 ```
-
 ### ParamSet2
 
 ```powershell
-Get-SPOApplication [[-OwningApplicationId] <OwningApplicationid>] [[-ApplicationId] <ApplicationId>]
+Get-SPOApplication [[-OwningApplicationId] <Guid>] [<CommonParameters>]
+```
+
+### ParamSet3
+
+```powershell
+Get-SPOApplication [[-OwningApplicationId] <Guid>] [[-ApplicationId] <Guid>][<CommonParameters>]
 ``` 
 
 ## DESCRIPTION
 
-The `Get-SPOApplication` cmdlet retrieves and returns SharePoint Embedded applications of all publishers registered in a tenant that match the given criteria. You must be a SharePoint Administrator to run the cmdlet. For permissions and the most current information about Windows PowerShell, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
+This cmdlet is used to retrieve and return SharePoint Embedded applications from all publishers registered within a tenant. This cmdlet can be further customized by pairing it with the `OwningApplicationId` parameter to target a specific application.
+
+In addition to providing details about the application name, this cmdlet also returns essential information about guest applications and their associated permissions on the owning application. The cmdlet displays data related to the sharing capabilities, including the `OverrideTenantSharingCapability` status. Furthermore, the cmdlet lists all host URLs allowed to use the SharePoint Embedded application's declarative agent experience.
+
+You must be a SharePoint Embedded Administrator to run the cmdlet. 
+
 
 ## EXAMPLES
 
@@ -50,7 +64,7 @@ Example 1 returns all SharePoint Embedded applications registered in the specifi
 Get-SPOApplication -OwningApplicationId <OwningApplicationId>
 ```
 
-Example 2 provides details about the owning application in the specified tenant. It returns Applications, which includes the list of guest application IDs with permissions to the owning application, as well as the SharingCapability settings and the OverrideTenantSharingCapability status
+Example 2 provides details about the application corresponding to the owning application Id in the specified tenant. It returns applications, which includes the list of guest application IDs with permissions to the owning application, as well as the SharingCapability settings, the `OverrideTenantSharingCapability` status and the list of all Copilot embedded chat host URLs. 
 
 ### Example 3
 
@@ -59,6 +73,15 @@ Get-SPOApplication -OwningApplicationId <OwningApplicationId> -ApplicationId <Ap
 ```
 
 Example 3 enumerates app-only permissions of the guest application specified in `ApplicationId`.
+
+### Example 4
+
+```powershell
+Get-SPOApplication -OwningApplicationId <OwningApplicationId> | Select-Object CopilotEmbeddedChatHosts
+```
+
+Example 4 enumerates the entire list of the host URLs driving the Copilot embedded chat capability on the SharePoint Embedded application.
+
 ## PARAMETERS
 
 ### -OwningApplicationId
@@ -76,15 +99,16 @@ The following details are returned:
 - SharingCapability
 
 - OverrideTenantSharingCapability
+
+- CopilotEmbeddedChatHosts
 
 ```yaml
-Type: String
+Type: Guid
 Parameter Sets: (All)
 Aliases:
-Applicable: SharePoint
 
 Required: False
-Position: Named
+Position: 0
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
@@ -95,18 +119,17 @@ Accept wildcard characters: False
 Use this parameter to enumerate app-only permissions of the guest application id with access to the specified owning application.
 
 ```yaml
-Type: String
-Parameter Sets: ParamSet2
+Type: Guid
+Parameter Sets: (All)
 Aliases:
-Applicable: SharePoint
 
 Required: False
-Position: Named
+Position: 1
 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](https://go.microsoft.com/fwlink/?LinkID=113216).
@@ -115,4 +138,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## RELATED LINKS
 
 [Get-SPOContainer](./Get-SPOContainer.md)
+
 [Set-SPOApplication](./Set-SPOApplication.md)

sharepoint/sharepoint-ps/sharepoint-online/Get-SPOBuiltInFontPackageSettings.md

@@ -0,0 +1,41 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spobuiltinfontpackagesettings
+applicable: SharePoint Online
+title: Get-SPOBuiltInFontPackageSettings
+schema: 2.0.0
+author: Yixian15
+ms.author: yixianpu
+ms.reviewer:
+---
+
+# Get-SPOBuiltInFontPackageSettings
+
+## SYNOPSIS
+
+Use this cmdlet to get settings of [built-in font packages](/sharepoint/brand-center-font-packages).
+ 
+## SYNTAX
+
+```powershell
+Get-SPOBuiltInFontPackageSettings
+```
+
+## DESCRIPTION
+
+Use this cmdlet to get settings of [built-in font packages](/sharepoint/brand-center-font-packages).
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+Get-SPOBuiltInFontPackageSettings
+```
+
+This example retrieves the current settings of built-in font packages.
+
+## RELATED LINKS
+
+- [Set-SPOBuiltInFontPackageSettings](./Set-SPOBuiltInFontPackageSettings.md)

sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md

@@ -53,7 +53,7 @@ Specifies the entity that could cause oversharing and hence tracked by these rep
 Type: ReportEntityEnum
 Parameter Sets: GetAllReportsParameterSet
 Aliases:
-Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers
+Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers, PermissionsReport
 
 Required: True
 Position: Named

sharepoint/sharepoint-ps/sharepoint-online/New-SPOContainerType.md

@@ -21,18 +21,19 @@ This cmdlet creates a new container type of standard or trial status. The standa
 ### ParamSet1
 
 ```powershell
-New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
+New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-GovernableByAdmin] <Boolean> [<CommonParameters>]
 ```
 
 ### ParamSet2
 
 ```powershell
-New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-IsPassThroughBilling] [<CommonParameters>]
+New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-IsPassThroughBilling] [-GovernableByAdmin] <Boolean> [<CommonParameters>]
 ```
 
 ### ParamSet3
+
 ```powershell
-New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
+New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-GovernableByAdmin] <Boolean>  [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -49,9 +50,11 @@ You must be a SharePoint Embedded Administrator to run this cmdlet.
 ```powershell
 New-SPOContainerType -ContainerTypeName ContosoLegal -OwningApplicationId a735e4af  
 ```
+
 In Example 1, the cmdlet creates a new regular billed container type ContosoLegal.
 
 ### Example 2  
+
 ```powershell
 New-SPOContainerType –IsPassThroughBilling –ContainerTypeName ContosoLegal -OwningApplicationId a735e4af
 ```
@@ -61,13 +64,20 @@ In Example 2, the cmdlet creates a direct to customer billed container type Cont
 ### Example 3   
 
 ```powershell 
-
 New-SPOContainerType –TrialContainerType -ContainerTypeName ContosoLegal -OwningApplicationId a735e4af
-
 ``` 
 
 In Example 3, the cmdlet creates a trial container type, ContosoLegal, valid for 30 days. 
 
+### Example 4   
+
+```powershell 
+New-SPOContainerType -ContainerTypeName ContosoLegal -OwningApplicationId a735e4af -GovernableByAdmin $false
+``` 
+
+In Example 4, the cmdlet creates a standard container type, ContosoLegal that has opted out of management through Microsoft-enabled administrator platforms. 
+
+
 ## PARAMETERS
 
 ### -ContainerTypeName
@@ -106,6 +116,7 @@ Accept wildcard characters: False
 
 
 ###  –TrialContainerType
+
 This parameter is used to specify that the cmdlet is used to create a trial container type and thereby the billing profile need not be provided.
 
 ```yaml
@@ -122,6 +133,7 @@ Accept wildcard characters: False
 ```
 
 ###  –IsPassThroughBilling
+
 This parameter is used to create a direct to customer billed container type.
 
 ```yaml
@@ -137,6 +149,22 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+###  –GovernableByAdmin
+
+Using `-GovernableByAdmin`, you can decide whether consuming tenant administrators of the application should be provided management capabilities on Microsoft-enabled administrator support, through SharePoint admin center and PowerShell. By default, the value is set to True. When set to False, the consuming tenant administrator can perform only read-only actions on containers of the container type, in both SharePoint admin center and PowerShell.
+
+```yaml
+Type: Boolean
+Parameter Sets:
+Aliases:
+Applicable: SharePoint Online
+
+Required: False
+Position: Named
+Default value: True
+Accept pipeline input: False
+Accept wildcard characters: False
+```
 
 ## RELATED LINKS