Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Remove-AzADServicePrincipal

Deletes entity from service principal.

Syntax

ObjectIdParameterSet (Default)

Remove-AzADServicePrincipal
 -ObjectId <String>
 [-IfMatch <String>]
 [-DefaultProfile <PSObject>]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

ApplicationIdParameterSet

Remove-AzADServicePrincipal
 -ApplicationId <Guid>
 [-IfMatch <String>]
 [-DefaultProfile <PSObject>]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

SPNParameterSet

Remove-AzADServicePrincipal
 -ServicePrincipalName <String>
 [-IfMatch <String>]
 [-DefaultProfile <PSObject>]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

DisplayNameParameterSet

Remove-AzADServicePrincipal
 -DisplayName <String>
 [-IfMatch <String>]
 [-DefaultProfile <PSObject>]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

InputObjectParameterSet

Remove-AzADServicePrincipal
 -InputObject <IMicrosoftGraphServicePrincipal>
 [-IfMatch <String>]
 [-DefaultProfile <PSObject>]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

ApplicationObjectParameterSet

Remove-AzADServicePrincipal
 -ApplicationObject <IMicrosoftGraphApplication>
 [-IfMatch <String>]
 [-DefaultProfile <PSObject>]
 [-PassThru]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Description

Deletes entity from service principal.

Examples

Example 1: Remove service principal by display name

Remove-AzADServicePrincipal -DisplayName $name

Remove service principal by display name

Example 2: Remove service principal by pipeline input

Get-AzADServicePrincipal -ApplicationId $id | Remove-AzADServicePrincipal

Remove service principal by pipeline input

Parameters

-ApplicationId

key: application id

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AppId

Parameter sets

-ApplicationObject

key: application object

Parameter properties

Type:IMicrosoftGraphApplication
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Parameter properties

Type:PSObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

-DisplayName

key: display name

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-IfMatch

ETag

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-InputObject

key: service principal object

Parameter properties

Type:IMicrosoftGraphServicePrincipal
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ObjectId

key: id of servicePrincipal

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ServicePrincipalId, Id, PrincipalId

Parameter sets

-PassThru

Returns true when the command succeeds

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ServicePrincipalName

key: service principal name

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SPN

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

IMicrosoftGraphApplication

IMicrosoftGraphServicePrincipal

Outputs

Boolean


Feedback

Was this page helpful?