| 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-sposerviceprioritizationbillingpolicy |
| schema | 2.0.0 |
Removes all app registrations linked to a SharePoint Online Service Prioritization billing policy and then deletes the billing policy itself.
Remove-SPOServicePrioritizationBillingPolicy -PolicyId <Guid> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]The Remove-SPOServicePrioritizationBillingPolicy cmdlet removes all app registrations associated with the specified billing policy in a single server-side operation, and then deletes the billing policy from Azure Resource Manager.
The billing policy is only deleted if all linked app registrations were successfully removed. If any registrations could not be confirmed as deleted, the billing policy is left intact and the unconfirmed app IDs are reported in FailedAppIds.
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.
Remove-SPOServicePrioritizationBillingPolicy -PolicyId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"Prompts for confirmation, then removes all app registrations linked to the specified billing policy and deletes the billing policy.
Remove-SPOServicePrioritizationBillingPolicy -PolicyId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ForceRemoves all app registrations linked to the specified billing policy and deletes the billing policy without prompting for confirmation.
The unique identifier of the SPO Service Prioritization billing policy to remove.
Type: Guid
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSuppresses the confirmation prompt. Without this switch, the cmdlet displays the number of app registrations and billing policy that will be deleted and requires confirmation before proceeding.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: FalseShows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsePrompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
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.
| 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 | true if the billing policy was successfully deleted from Azure Resource Manager; false if the policy could not be deleted (e.g., transient error or insufficient permissions) or if there were failed app registration deletions. |
If BillingPolicyDeleted is false and FailedAppIds is null, the app registrations were removed but the billing policy itself could not be deleted. The billing policy may need to be removed manually.
Get-SPOServicePrioritizationAppRegistrations
Remove-SPOServicePrioritizationAppRegistration
Remove-SPOServicePrioritizationAppRegistrationsByPolicy