Skip to content

Get-SPOServicePrioritizationAppRegistrations.md

Latest commit

 

History

History
105 lines (67 loc) · 3.19 KB

Get-SPOServicePrioritizationAppRegistrations.md

File metadata and controls

105 lines (67 loc) · 3.19 KB
external help file Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
Module Name Microsoft.Online.SharePoint.PowerShell
online version https://learn.microsoft.com/powershell/module/sharepoint-online/get-sposerviceprioritizationappregistrations
schema 2.0.0

Get-SPOServicePrioritizationAppRegistrations

SYNOPSIS

Returns app registrations enrolled in SharePoint Online Service Prioritization.

SYNTAX

All (Default)

Get-SPOServicePrioritizationAppRegistrations [<CommonParameters>]

ByPolicy

Get-SPOServicePrioritizationAppRegistrations -PolicyId <Guid> [<CommonParameters>]

DESCRIPTION

The Get-SPOServicePrioritizationAppRegistrations cmdlet retrieves all app registrations enrolled in SharePoint Online Service Prioritization for the tenant.

When -PolicyId is specified, only registrations linked to that billing policy are returned. The filtering is performed server-side, so only matching records are transferred.

You must be a SharePoint Online administrator to run this cmdlet.

EXAMPLES

Example 1: Get all app registrations

Get-SPOServicePrioritizationAppRegistrations

Returns all app registrations enrolled in SharePoint Online Service Prioritization for the tenant.

Example 2: Get app registrations for a specific billing policy

Get-SPOServicePrioritizationAppRegistrations -PolicyId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Returns only app registrations linked to the specified billing policy.

PARAMETERS

-PolicyId

The unique identifier of the SPO Service Prioritization billing policy to filter by. When specified, only app registrations linked to this policy are returned. When omitted, all app registrations for the tenant are returned.

Type: Guid
Parameter Sets: ByPolicy
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.

INPUTS

None

OUTPUTS

Microsoft.Online.SharePoint.PowerShell.SPOServicePrioritizationAppRegistrationCmdLetObj

Each output object has the following properties:

Property Type Description
AppId String The application (client) ID of the registered app.
PolicyId String The billing policy ID the app is linked to.
Enabled String Whether the registration is currently active.
QuotaMultiplier Int32 The throttling quota multiplier applied to this app (2–10).

NOTES

RELATED LINKS

Add-SPOServicePrioritizationAppRegistration

Remove-SPOServicePrioritizationAppRegistration

Remove-SPOServicePrioritizationAppRegistrationsByPolicy

Get-SPOServicePrioritizationBillingPolicies