Edit

Share via

New-AzureADDevice

  • Reference
Module:
AzureADPreview

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>]
   [-ProfileType <String>]
   [-SystemLabels <System.Collections.Generic.List`1[System.String]>]
   [<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.

Parameters

-AccountEnabled

Indicates whether the account is enabled.

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

-AlternativeSecurityIds

Type:List<T>[Microsoft.Open.AzureAD.Model.AlternativeSecurityId]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApproximateLastLogonTimeStamp

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

-DeviceId

Specifies the ID of the device.

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

-DeviceMetadata

The metadata for this device

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

-DeviceObjectVersion

Specifies the object version of the device.

Type:Int32
Position:Named
Default value:None
Required:False
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
Required:True
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DevicePhysicalIds

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceTrustType

The trust type for this device

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

-DisplayName

Specifies the display name of the new device.

Type:String
Position:Named
Default value:None
Required:True
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProfileType

{{ Fill ProfileType Description }}

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

-SystemLabels

{{ Fill SystemLabels Description }}

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False