Skip to content

Latest commit

 

History

History
282 lines (220 loc) · 5.64 KB

File metadata and controls

282 lines (220 loc) · 5.64 KB
external help file Module Name ms.assetid ms.custom ms.reviewer online version schema
Microsoft.Open.AzureAD16.Graph.PowerShell.dll-Help.xml
AzureADPreview
0DF2C468-53D8-4BC5-AFC8-7E8EDF38C347
iamfeature=PowerShell
rodejo
2.0.0

New-AzureADDevice

SYNOPSIS

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
Parameter Sets: (All)
Aliases:

Required: True
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]
Parameter Sets: (All)
Aliases:

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

-ApproximateLastLogonTimeStamp

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-DeviceId

Specifies the ID of the device.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeviceMetadata

The metadata for this device

Type: String
Parameter Sets: (All)
Aliases:

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

-DeviceObjectVersion

Specifies the object version of the device.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
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
Parameter Sets: (All)
Aliases:

Required: True
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
Parameter Sets: (All)
Aliases:

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

-DevicePhysicalIds

Type: System.Collections.Generic.List`1[System.String]
Parameter Sets: (All)
Aliases:

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

-DeviceTrustType

The trust type for this device

Type: String
Parameter Sets: (All)
Aliases:

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

-DisplayName

Specifies the display name of the new device.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
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
Parameter Sets: (All)
Aliases:

Required: False
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
Parameter Sets: (All)
Aliases:

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

-ProfileType

{{ Fill ProfileType Description }}

Type: String
Parameter Sets: (All)
Aliases:

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

-SystemLabels

{{ Fill SystemLabels Description }}

Type: System.Collections.Generic.List`1[System.String]
Parameter Sets: (All)
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Get-AzureADDevice

Remove-AzureADDevice

Set-AzureADDevice