Edit

Share via

Remove-EntraDevice

Module:
Microsoft.Entra.DirectoryManagement Module v1.1

Deletes a device.

Syntax

Default (Default) 

Remove-EntraDevice

    -DeviceId <String>
    [<CommonParameters>]

Description

The Remove-EntraDevice cmdlet removes a device from Microsoft Entra ID.

In delegated scenarios with work or school accounts, the signed-in user must have a supported Microsoft Entra role or a custom role with the required permissions. The following least privileged roles are supported:

  • Intune Administrator
  • Windows 365 Administrator
  • Cloud Device Administrator

Examples

Example 1: Remove a device

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
Remove-EntraDevice -DeviceId $device.Id

This command removes the specified device.

Parameters

-DeviceId

Specifies the object ID of a device in Microsoft Entra ID.

Parameter properties

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

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.