Remove-EntraDomain

Module:: Microsoft.Entra Module v1.1

Removes a domain.

Syntax

Default (Default)

Remove-EntraDomain

    -Name <String>
    [<CommonParameters>]

Description

The Remove-EntraDomain cmdlet removes a domain from Microsoft Entra ID.

Important:

Deleted domains are not recoverable.
Attempts to delete will fail if there are any resources or objects still dependent on the domain.

In delegated scenarios, the signed-in user must have either a supported Microsoft Entra role or a custom role with the necessary permissions. The minimum roles required for this operation are:

Domain Name Administrator

Examples

Example 1: Remove a domain

Connect-Entra -Scopes 'Domain.ReadWrite.All'
Remove-EntraDomain -Name Contoso.com

This command removes a domain from Microsoft Entra ID.

Parameters

-Name

Specifies the name of the domain to remove.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	True
Value from remaining arguments:	False

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.