| external help file | Microsoft.Online.SharePoint.PowerShell.dll-Help.xml |
|---|---|
| Module Name | Microsoft.Online.SharePoint.PowerShell |
| online version | https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/get-spoapplication |
| applicable | SharePoint |
| title | Get-SPOApplication |
| schema | 2.0.0 |
| author | ShreyasSar26 |
| ms.author | shsaravanan |
| ms.reviewer |
Returns a list of SharePoint Embedded applications in the specified tenant.
Get-SPOApplication [[-OwningApplicationId] <Guid>] [[-ApplicationId] <Guid>] [<CommonParameters>]
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.
Get-SPOApplicationExample 1 returns all SharePoint Embedded applications registered in the specified tenant by their OwningApplicationId and OwningApplicationName.
Get-SPOApplication -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cfExample 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.
Get-SPOApplication -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ApplicationId 12345678-1234-1234-abcd-abcdefghijklExample 3 enumerates app-only permissions of the guest application specified in ApplicationId.
Get-SPOApplication -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | Select-Object CopilotEmbeddedChatHostsExample 4 enumerates the entire list of the host URLs driving the Copilot embedded chat capability on the SharePoint Embedded application.
Use this parameter to enumerate app-only permissions of the guest application id with access to the specified owning application.
Type: System.Guid
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseUse this parameter to get details about applications registered in the specified tenant.
The following details are returned:
-
OwningApplicationId
-
OwningApplicationName
-
Applications (by id)
-
SharingCapability
-
OverrideTenantSharingCapability
-
CopilotEmbeddedChatHosts
Type: System.Guid
Parameter Sets: (All)
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.