Skip to content

Latest commit

 

History

History
140 lines (94 loc) · 3.67 KB

File metadata and controls

140 lines (94 loc) · 3.67 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/remove-sposerviceprioritizationappregistrationsbypolicy
title Remove-SPOServicePrioritizationAppRegistrationsByPolicy
schema 2.0.0
author juanoriana
ms.author
ms.reviewer

Remove-SPOServicePrioritizationAppRegistrationsByPolicy

SYNOPSIS

Removes all app registrations linked to a specific SharePoint Online Service Prioritization billing policy.

SYNTAX

Remove-SPOServicePrioritizationAppRegistrationsByPolicy -PolicyId <Guid> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

This cmdlet removes all app registrations associated with the specified billing policy.

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.

EXAMPLES

Example 1

Remove-SPOServicePrioritizationAppRegistrationsByPolicy -PolicyId 11111111-1111-1111-1111-111111111111

Example 1 prompts for confirmation, then removes all app registrations linked to the specified billing policy.

Example 2

Remove-SPOServicePrioritizationAppRegistrationsByPolicy -PolicyId 11111111-1111-1111-1111-111111111111 -Force

Example 2 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.

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.

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.

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.

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.

INPUTS

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

Get-SPOServicePrioritizationAppRegistrations

Add-SPOServicePrioritizationAppRegistration

Remove-SPOServicePrioritizationAppRegistration

Remove-SPOServicePrioritizationBillingPolicy

Get-SPOServicePrioritizationBillingPolicies