New-MgDeviceManagementWindowsAutopilotDeviceIdentity

Module:

Microsoft.Graph.DeviceManagement.Enrollment

Create a new windowsAutopilotDeviceIdentity object.

Note

To view the beta release of this cmdlet, view New-MgBetaDeviceManagementWindowsAutopilotDeviceIdentity

Syntax

New-MgDeviceManagementWindowsAutopilotDeviceIdentity
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-AddressableUserName <String>]
   [-AzureActiveDirectoryDeviceId <String>]
   [-DisplayName <String>]
   [-EnrollmentState <EnrollmentState>]
   [-GroupTag <String>]
   [-Id <String>]
   [-LastContactedDateTime <DateTime>]
   [-ManagedDeviceId <String>]
   [-Manufacturer <String>]
   [-Model <String>]
   [-ProductKey <String>]
   [-PurchaseOrderIdentifier <String>]
   [-ResourceName <String>]
   [-SerialNumber <String>]
   [-SkuNumber <String>]
   [-SystemFamily <String>]
   [-UserPrincipalName <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgDeviceManagementWindowsAutopilotDeviceIdentity
   -BodyParameter <IMicrosoftGraphWindowsAutopilotDeviceIdentity>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a new windowsAutopilotDeviceIdentity object.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.DeviceManagement.Enrollment

$params = @{
	"@odata.type" = "#microsoft.graph.windowsAutopilotDeviceIdentity"
	groupTag = "Group Tag value"
	purchaseOrderIdentifier = "Purchase Order Identifier value"
	serialNumber = "Serial Number value"
	productKey = "Product Key value"
	manufacturer = "Manufacturer value"
	model = "Model value"
	enrollmentState = "enrolled"
	lastContactedDateTime = [System.DateTime]::Parse("2016-12-31T23:58:44.2908994-08:00")
	addressableUserName = "Addressable User Name value"
	userPrincipalName = "User Principal Name value"
	resourceName = "Resource Name value"
	skuNumber = "Sku Number value"
	systemFamily = "System Family value"
	azureActiveDirectoryDeviceId = "Azure Active Directory Device Id value"
	managedDeviceId = "Managed Device Id value"
	displayName = "Display Name value"
}

New-MgDeviceManagementWindowsAutopilotDeviceIdentity -BodyParameter $params

This example shows how to use the New-MgDeviceManagementWindowsAutopilotDeviceIdentity Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-AddressableUserName

Addressable user name.

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

-AzureActiveDirectoryDeviceId

AAD Device ID - to be deprecated

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

-BodyParameter

The windowsAutopilotDeviceIdentity resource represents a Windows Autopilot Device. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DisplayName

Display Name

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

-EnrollmentState

enrollmentState

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

-GroupTag

Group Tag of the Windows autopilot device.

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-LastContactedDateTime

Intune Last Contacted Date Time of the Windows autopilot device.

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

-ManagedDeviceId

Managed Device ID

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

-Manufacturer

Oem manufacturer of the Windows autopilot device.

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

-Model

Model name of the Windows autopilot device.

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

-ProductKey

Product Key of the Windows autopilot device.

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PurchaseOrderIdentifier

Purchase Order Identifier of the Windows autopilot device.

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

-ResourceName

Resource Name.

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

-ResponseHeadersVariable

Optional Response Headers Variable.

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

-SerialNumber

Serial number of the Windows autopilot device.

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

-SkuNumber

SKU Number

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

-SystemFamily

System Family

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

-UserPrincipalName

User Principal Name.

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

Inputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphWindowsAutopilotDeviceIdentity

System.Collections.IDictionary

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphWindowsAutopilotDeviceIdentity

Notes

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.

BODYPARAMETER <IMicrosoftGraphWindowsAutopilotDeviceIdentity>: The windowsAutopilotDeviceIdentity resource represents a Windows Autopilot Device.

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [AddressableUserName <String>]: Addressable user name.
• [AzureActiveDirectoryDeviceId <String>]: AAD Device ID - to be deprecated
• [DisplayName <String>]: Display Name
• [EnrollmentState <EnrollmentState?>]: enrollmentState
• [GroupTag <String>]: Group Tag of the Windows autopilot device.
• [LastContactedDateTime <DateTime?>]: Intune Last Contacted Date Time of the Windows autopilot device.
• [ManagedDeviceId <String>]: Managed Device ID
• [Manufacturer <String>]: Oem manufacturer of the Windows autopilot device.
• [Model <String>]: Model name of the Windows autopilot device.
• [ProductKey <String>]: Product Key of the Windows autopilot device.
• [PurchaseOrderIdentifier <String>]: Purchase Order Identifier of the Windows autopilot device.
• [ResourceName <String>]: Resource Name.
• [SerialNumber <String>]: Serial number of the Windows autopilot device.
• [SkuNumber <String>]: SKU Number
• [SystemFamily <String>]: System Family
• [UserPrincipalName <String>]: User Principal Name.

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.devicemanagement.enrollment/new-mgdevicemanagementwindowsautopilotdeviceidentity
• https://learn.microsoft.com/graph/api/intune-enrollment-windowsautopilotdeviceidentity-create?view=graph-rest-1.0