New-​Azure​AD​Device

Creates a device.

Syntax

New-AzureADDevice
   -AccountEnabled <Boolean>
   -AlternativeSecurityIds <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AlternativeSecurityId]>
   [-ApproximateLastLogonTimeStamp <DateTime>]
   -DeviceId <String>
   [-DeviceMetadata <String>]
   [-DeviceObjectVersion <Int32>]
   -DeviceOSType <String>
   -DeviceOSVersion <String>
   [-DevicePhysicalIds <System.Collections.Generic.List`1[System.String]>]
   [-DeviceTrustType <String>]
   -DisplayName <String>
   [-IsCompliant <Boolean>]
   [-IsManaged <Boolean>]
   [<CommonParameters>]

Description

The New-AzureADDevice cmdlet creates a device in Azure Active Directory (AD).

Examples

Example 1: Create a device

PS C:\>New-AzureADDevice -AccountEnabled $true -DisplayName "My new device" -AlternativeSecurityIds $altsecid -DeviceId $guid -DeviceOSType "OS/2" -DeviceOSVersion "9.3"

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
99a1915d-298f-42d1-93ae-71646b85e2fa 5547679b-809d-4e2c-9820-3c4401a573a8 My new device

This command creates a new device.

Required Parameters

-AccountEnabled

Indicates whether the account is enabled.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AlternativeSecurityIds
Type:System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AlternativeSecurityId]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceId

Specifies the ID of the device.

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

Specifies the operating system type of the new device.

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

Specifies the operating system version of the new device.

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

Specifies the display name of the new device.

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

Optional Parameters

-ApproximateLastLogonTimeStamp
Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceMetadata

The metadata for this device

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

Specifies the object version of the device.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DevicePhysicalIds
Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceTrustType

The trust type for this device

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

true if the device complies with Mobile Device Management (MDM) policies; otherwise, false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsManaged

true if the device is managed by a Mobile Device Management (MDM) app such as Intune; otherwise, false

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