Skip to content

Remove-EntraServicePrincipal

SYNOPSIS

Removes an Azure Service Principal system account and associated PasswordState entries.

SYNTAX

Remove-EntraServicePrincipal [-ServicePrincipalName] <String> [-onderwijs] [<CommonParameters>]

DESCRIPTION

The `Remove-EntraServicePrincipal` function deletes an Azure Service Principal system account from Azure Active Directory. It also checks for and removes any associated entries in PasswordState. The function supports connecting to the "onderwijs" tenant and handles authentication using Microsoft Graph.

EXAMPLES

EXAMPLE 1

Remove-EntraServicePrincipal -ServicePrincipalName "MyServicePrincipal"

Removes the Service Principal named "MyServicePrincipal" and its associated PasswordState entries.

EXAMPLE 2

Remove-EntraServicePrincipal -ServicePrincipalName "MyServicePrincipal" -onderwijs

Removes the Service Principal named "MyServicePrincipal" in the "onderwijs" tenant and its associated PasswordState entries.

PARAMETERS

-ServicePrincipalName

The name of the Service Principal to be removed.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-onderwijs

A switch parameter that, when specified, connects to the "onderwijs" tenant for the operation.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
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

OUTPUTS

NOTES