Remove-MgDevice

  • Reference
Module:
Microsoft.Graph.Identity.DirectoryManagement

Delete a registered device.

Syntax

Remove-MgDevice
      -DeviceId <String>
      [-IfMatch <String>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-MgDevice
      -InputObject <IIdentityDirectoryManagementIdentity>
      [-IfMatch <String>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Delete a registered device.

Examples

Example 1: Using the Remove-MgDevice Cmdlet

Import-Module Microsoft.Graph.Identity.DirectoryManagement
Remove-MgDevice -DeviceId $deviceId

This example shows how to use the Remove-MgDevice Cmdlet. To learn about permissions for this resource, see the permissions reference.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

key: id of device

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IfMatch

ETag

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Identity Parameter To construct, please use Get-Help -Online and see NOTES section for INPUTOBJECT properties and create a hash table.

Type:IIdentityDirectoryManagementIdentity
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Returns true when the command succeeds

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.PowerShell.Models.IIdentityDirectoryManagementIdentity

Outputs

System.Boolean

Notes

ALIASES

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

INPUTOBJECT <IIdentityDirectoryManagementIdentity>: Identity Parameter

  • [AdministrativeUnitId <String>]: key: id of administrativeUnit
  • [AllowedValueId <String>]: key: id of allowedValue
  • [AttributeSetId <String>]: key: id of attributeSet
  • [CommandId <String>]: key: id of command
  • [ContractId <String>]: key: id of contract
  • [CustomSecurityAttributeDefinitionId <String>]: key: id of customSecurityAttributeDefinition
  • [DeviceId <String>]: key: id of device
  • [DirectoryObjectId <String>]: key: id of directoryObject
  • [DirectoryRoleId <String>]: key: id of directoryRole
  • [DirectoryRoleTemplateId <String>]: key: id of directoryRoleTemplate
  • [DirectorySettingId <String>]: key: id of directorySetting
  • [DirectorySettingTemplateId <String>]: key: id of directorySettingTemplate
  • [DomainDnsRecordId <String>]: key: id of domainDnsRecord
  • [DomainId <String>]: key: id of domain
  • [ExtensionId <String>]: key: id of extension
  • [FeatureRolloutPolicyId <String>]: key: id of featureRolloutPolicy
  • [IdentityProviderBaseId <String>]: key: id of identityProviderBase
  • [ImpactedResourceId <String>]: key: id of impactedResource
  • [InboundSharedUserProfileUserId <String>]: key: userId of inboundSharedUserProfile
  • [InternalDomainFederationId <String>]: key: id of internalDomainFederation
  • [OnPremisesDirectorySynchronizationId <String>]: key: id of onPremisesDirectorySynchronization
  • [OrgContactId <String>]: key: id of orgContact
  • [OrganizationId <String>]: key: id of organization
  • [OrganizationalBrandingLocalizationId <String>]: key: id of organizationalBrandingLocalization
  • [OutboundSharedUserProfileUserId <String>]: key: userId of outboundSharedUserProfile
  • [ProfileCardPropertyId <String>]: key: id of profileCardProperty
  • [RecommendationId <String>]: key: id of recommendation
  • [ScopedRoleMembershipId <String>]: key: id of scopedRoleMembership
  • [SharedEmailDomainId <String>]: key: id of sharedEmailDomain
  • [SharedEmailDomainInvitationId <String>]: key: id of sharedEmailDomainInvitation
  • [SubscribedSkuId <String>]: key: id of subscribedSku
  • [TenantReferenceTenantId <String>]: key: tenantId of tenantReference
  • [UsageRightId <String>]: key: id of usageRight
  • [UserId <String>]: key: id of user