Add/update SPO Service Prioritization cmdlet docs

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOServicePrioritizationAppRegistrations.md

@@ -1,41 +1,78 @@
 ---
 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-SPOServicePrioritizationAppRegistrations
-applicable: SharePoint Online
-title: Get-SPOServicePrioritizationAppRegistrations
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-sposerviceprioritizationappregistrations
 schema: 2.0.0
-author: samkabue
-ms.author: speedta
-ms.reviewer: speedta
 ---
 
 # Get-SPOServicePrioritizationAppRegistrations
 
 ## SYNOPSIS
-Retrieves the list of app registrations configured for service prioritization in SharePoint Online.
 
+Returns app registrations enrolled in SharePoint Online Service Prioritization.
 
 ## SYNTAX
 
-```
+### All (Default)
+
+```powershell
 Get-SPOServicePrioritizationAppRegistrations [<CommonParameters>]
 ```
 
+### ByPolicy
+
+```powershell
+Get-SPOServicePrioritizationAppRegistrations -PolicyId <Guid> [<CommonParameters>]
+```
+
 ## DESCRIPTION
-This cmdlet retrieves all app registrations that have been configured for service prioritization in SharePoint Online. This cmdlet is useful for administrators who need to review or audit the current app registrations and their associated policies.
+
+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
+### Example 1: Get all app registrations
+
 ```powershell
 Get-SPOServicePrioritizationAppRegistrations
 ```
-This example retrieves all app registrations configured for service prioritization in SharePoint Online.
+
+Returns all app registrations enrolled in SharePoint Online Service Prioritization for the tenant.
+
+### Example 2: Get app registrations for a specific billing policy
+
+```powershell
+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.
+
+```yaml
+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](https://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS
@@ -44,20 +81,25 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## OUTPUTS
 
-### System.Object
+### Microsoft.Online.SharePoint.PowerShell.SPOServicePrioritizationAppRegistrationCmdLetObj
 
-## NOTES
+Each output object has the following properties:
 
-## RELATED LINKS
+| 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). |
 
-[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online)
+## NOTES
 
-[Add-SPOServicePrioritizationAppRegistration](./Add-SPOServicePrioritizationAppRegistration.md)
+## RELATED LINKS
 
-[Remove-SPOServicePrioritizationAppRegistration](./Remove-SPOServicePrioritizationAppRegistration.md)
+[Add-SPOServicePrioritizationAppRegistration](Add-SPOServicePrioritizationAppRegistration.md)
 
-[New-SPOServicePrioritizationBillingPolicy](./New-SPOServicePrioritizationBillingPolicy.md)
+[Remove-SPOServicePrioritizationAppRegistration](Remove-SPOServicePrioritizationAppRegistration.md)
 
-[Get-SPOServicePrioritizationBillingPolicies](./Get-SPOServicePrioritizationBillingPolicies.md)
+[Remove-SPOServicePrioritizationAppRegistrationsByPolicy](Remove-SPOServicePrioritizationAppRegistrationsByPolicy.md)
 
-[Set-SPOServicePrioritizationAppRegistration](./Set-SPOServicePrioritizationAppRegistration.md)
+[Get-SPOServicePrioritizationBillingPolicies](Get-SPOServicePrioritizationBillingPolicies.md)

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md

@@ -570,7 +570,13 @@ Removes a given public CDN origin based on its identity (id) in your SharePoint
 Removes Software-Defined Networking (SDN) Support in your SharePoint Online tenant
 
 ### [Remove-SPOServicePrioritizationAppRegistration](Remove-SPOServicePrioritizationAppRegistration.md)
-Removes an app registration from service prioritization in SharePoint Online. 
+Removes an app registration from service prioritization in SharePoint Online.
+
+### [Remove-SPOServicePrioritizationAppRegistrationsByPolicy](Remove-SPOServicePrioritizationAppRegistrationsByPolicy.md)
+Removes all app registrations linked to a specific SharePoint Online Service Prioritization billing policy.
+
+### [Remove-SPOServicePrioritizationBillingPolicy](Remove-SPOServicePrioritizationBillingPolicy.md)
+Removes all app registrations linked to a SharePoint Online Service Prioritization billing policy and then deletes the billing policy itself.
 
 ### [Remove-SPOSite](Remove-SPOSite.md)
 Sends a SharePoint Online site collection to the SharePoint Online Recycle Bin.

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOServicePrioritizationAppRegistrationsByPolicy.md

@@ -0,0 +1,144 @@
+---
+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/remove-sposerviceprioritizationappregistrationsbypolicy
+schema: 2.0.0
+---
+
+# Remove-SPOServicePrioritizationAppRegistrationsByPolicy
+
+## SYNOPSIS
+
+Removes all app registrations linked to a specific SharePoint Online Service Prioritization billing policy.
+
+## SYNTAX
+
+```powershell
+Remove-SPOServicePrioritizationAppRegistrationsByPolicy -PolicyId <Guid> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+The `Remove-SPOServicePrioritizationAppRegistrationsByPolicy` cmdlet removes all app registrations associated with the specified billing policy in a single server-side operation.
+
+Before deletion, the cmdlet verifies that the billing policy exists and that at least one app registration is linked to it. If neither condition is met, the cmdlet exits silently.
+
+By default, the cmdlet prompts for confirmation before deleting. Use `-Force` to suppress the confirmation prompt.
+
+You must be a SharePoint Online administrator to run this cmdlet.
+
+## EXAMPLES
+
+### Example 1: Remove all app registrations for a billing policy
+
+```powershell
+Remove-SPOServicePrioritizationAppRegistrationsByPolicy -PolicyId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+```
+
+Prompts for confirmation, then removes all app registrations linked to the specified billing policy.
+
+### Example 2: Remove without confirmation prompt
+
+```powershell
+Remove-SPOServicePrioritizationAppRegistrationsByPolicy -PolicyId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Force
+```
+
+Removes all app registrations linked to the specified billing policy without prompting for confirmation.
+
+## PARAMETERS
+
+### -PolicyId
+
+The unique identifier of the SPO Service Prioritization billing policy whose app registrations should be removed.
+
+```yaml
+Type: Guid
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Force
+
+Suppresses the confirmation prompt. Without this switch, the cmdlet displays the number of app registrations that will be deleted and requires confirmation before proceeding.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+
+Shows what would happen if the cmdlet runs. The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+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](https://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### Microsoft.Online.SharePoint.PowerShell.SPOServicePrioritizationBulkDeleteResult
+
+| Property | Type | Description |
+|---|---|---|
+| SuccessCount | Int32 | The number of app registrations successfully removed. |
+| FailedAppIds | List\<String\> | App IDs that could not be confirmed as deleted, populated only when the server reports fewer deletions than expected. `null` when all registrations were deleted successfully. |
+| BillingPolicyDeleted | Boolean | Always `false` for this cmdlet. Use `Remove-SPOServicePrioritizationBillingPolicy` to delete the billing policy. |
+
+## NOTES
+
+## RELATED LINKS
+
+[Get-SPOServicePrioritizationAppRegistrations](Get-SPOServicePrioritizationAppRegistrations.md)
+
+[Add-SPOServicePrioritizationAppRegistration](Add-SPOServicePrioritizationAppRegistration.md)
+
+[Remove-SPOServicePrioritizationAppRegistration](Remove-SPOServicePrioritizationAppRegistration.md)
+
+[Remove-SPOServicePrioritizationBillingPolicy](Remove-SPOServicePrioritizationBillingPolicy.md)
+
+[Get-SPOServicePrioritizationBillingPolicies](Get-SPOServicePrioritizationBillingPolicies.md)