< Back

New-ManagedDeviceObject

Sat Jan 18, 2020 12:36 pm

NAME New-ManagedDeviceObject



SYNOPSIS

Creates a new object which represents a "microsoft.graph.managedDevice" (or one of its derived types).





SYNTAX

New-ManagedDeviceObject [-activationLockBypassCode <string>] [-androidSecurityPatchLevel <string>]

[-azureADDeviceId <string>] [-azureADRegistered <bool>] [-complianceGracePeriodExpirationDateTime

<DateTimeOffset>] [-complianceState <string>] [-configurationManagerClientEnabledFeatures <object>]

[-deviceActionResults <object[]>] [-deviceCategory <object>] [-deviceCategoryDisplayName <string>]

[-deviceCompliancePolicyStates <object[]>] [-deviceConfigurationStates <object[]>] [-deviceEnrollmentType

<string>] [-deviceHealthAttestationState <object>] [-deviceName <string>] [-deviceRegistrationState <string>]

[-easActivated <bool>] [-easActivationDateTime <DateTimeOffset>] [-easDeviceId <string>] [-emailAddress <string>]

[-enrolledDateTime <DateTimeOffset>] [-exchangeAccessState <string>] [-exchangeAccessStateReason <string>]

[-exchangeLastSuccessfulSyncDateTime <DateTimeOffset>] [-freeStorageSpaceInBytes <long>] [-imei <string>]

[-isEncrypted <bool>] [-isSupervised <bool>] [-jailBroken <string>] [-lastSyncDateTime <DateTimeOffset>]

[-managedDeviceName <string>] [-managedDeviceOwnerType <string>] [-managementAgent <string>] [-manufacturer

<string>] [-meid <string>] [-model <string>] [-operatingSystem <string>] [-osVersion <string>]

[-partnerReportedThreatState <string>] [-phoneNumber <string>] [-remoteAssistanceSessionErrorDetails <string>]

[-remoteAssistanceSessionUrl <string>] [-serialNumber <string>] [-subscriberCarrier <string>]

[-totalStorageSpaceInBytes <long>] [-userDisplayName <string>] [-userId <string>] [-userPrincipalName <string>]

[-wiFiMacAddress <string>] [<CommonParameters>]





DESCRIPTION

Creates a new object which represents a "microsoft.graph.managedDevice" (or one of its derived types).



Devices that are managed or pre-enrolled through Intune





PARAMETERS

-userId <string>

The "userId" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Unique Identifier for the user associated with the device



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceName <string>

The "deviceName" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Name of the device



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-managedDeviceOwnerType <string>

The "managedDeviceOwnerType" property, of type "microsoft.graph.managedDeviceOwnerType".



This property is on the "microsoft.graph.managedDevice" type.



Ownership of the device. Can be 'company' or 'personal'



Valid values: 'unknown', 'company', 'personal'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceActionResults <object[]>

The "deviceActionResults" property, of type "microsoft.graph.deviceActionResult".



This property is on the "microsoft.graph.managedDevice" type.



List of ComplexType deviceActionResult objects.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-enrolledDateTime <DateTimeOffset>

The "enrolledDateTime" property, of type "Edm.DateTimeOffset".



This property is on the "microsoft.graph.managedDevice" type.



Enrollment time of the device.



Required? false

Position? named

Default value 1/1/0001 12:00:00 AM +00:00

Accept pipeline input? false

Accept wildcard characters? false



-lastSyncDateTime <DateTimeOffset>

The "lastSyncDateTime" property, of type "Edm.DateTimeOffset".



This property is on the "microsoft.graph.managedDevice" type.



The date and time that the device last completed a successful sync with Intune.



Required? false

Position? named

Default value 1/1/0001 12:00:00 AM +00:00

Accept pipeline input? false

Accept wildcard characters? false



-operatingSystem <string>

The "operatingSystem" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Operating system of the device. Windows, iOS, etc.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-complianceState <string>

The "complianceState" property, of type "microsoft.graph.complianceState".



This property is on the "microsoft.graph.managedDevice" type.



Compliance state of the device.



Valid values: 'unknown', 'compliant', 'noncompliant', 'conflict', 'error', 'inGracePeriod', 'configManager'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-jailBroken <string>

The "jailBroken" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



whether the device is jail broken or rooted.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-managementAgent <string>

The "managementAgent" property, of type "microsoft.graph.managementAgentType".



This property is on the "microsoft.graph.managedDevice" type.



Management channel of the device. Intune, EAS, etc.



Valid values: 'eas', 'mdm', 'easMdm', 'intuneClient', 'easIntuneClient', 'configurationManagerClient',

'configurationManagerClientMdm', 'configurationManagerClientMdmEas', 'unknown', 'jamf',

'googleCloudDevicePolicyController'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-osVersion <string>

The "osVersion" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Operating system version of the device.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-easActivated <bool>

The "easActivated" property, of type "Edm.Boolean".



This property is on the "microsoft.graph.managedDevice" type.



Whether the device is Exchange ActiveSync activated.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-easDeviceId <string>

The "easDeviceId" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Exchange ActiveSync Id of the device.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-easActivationDateTime <DateTimeOffset>

The "easActivationDateTime" property, of type "Edm.DateTimeOffset".



This property is on the "microsoft.graph.managedDevice" type.



Exchange ActivationSync activation time of the device.



Required? false

Position? named

Default value 1/1/0001 12:00:00 AM +00:00

Accept pipeline input? false

Accept wildcard characters? false



-azureADRegistered <bool>

The "azureADRegistered" property, of type "Edm.Boolean".



This property is on the "microsoft.graph.managedDevice" type.



Whether the device is Azure Active Directory registered.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-deviceEnrollmentType <string>

The "deviceEnrollmentType" property, of type "microsoft.graph.deviceEnrollmentType".



This property is on the "microsoft.graph.managedDevice" type.



Enrollment type of the device.



Valid values: 'unknown', 'userEnrollment', 'deviceEnrollmentManager', 'appleBulkWithUser',

'appleBulkWithoutUser', 'windowsAzureADJoin', 'windowsBulkUserless', 'windowsAutoEnrollment',

'windowsBulkAzureDomainJoin', 'windowsCoManagement'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-activationLockBypassCode <string>

The "activationLockBypassCode" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Code that allows the Activation Lock on a device to be bypassed.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-emailAddress <string>

The "emailAddress" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Email(s) for the user associated with the device



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-azureADDeviceId <string>

The "azureADDeviceId" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



The unique identifier for the Azure Active Directory device. Read only.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceRegistrationState <string>

The "deviceRegistrationState" property, of type "microsoft.graph.deviceRegistrationState".



This property is on the "microsoft.graph.managedDevice" type.



Device registration state.



Valid values: 'notRegistered', 'registered', 'revoked', 'keyConflict', 'approvalPending', 'certificateReset',

'notRegisteredPendingEnrollment', 'unknown'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceCategoryDisplayName <string>

The "deviceCategoryDisplayName" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Device category display name



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-isSupervised <bool>

The "isSupervised" property, of type "Edm.Boolean".



This property is on the "microsoft.graph.managedDevice" type.



Device supervised status



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-exchangeLastSuccessfulSyncDateTime <DateTimeOffset>

The "exchangeLastSuccessfulSyncDateTime" property, of type "Edm.DateTimeOffset".



This property is on the "microsoft.graph.managedDevice" type.



Last time the device contacted Exchange.



Required? false

Position? named

Default value 1/1/0001 12:00:00 AM +00:00

Accept pipeline input? false

Accept wildcard characters? false



-exchangeAccessState <string>

The "exchangeAccessState" property, of type "microsoft.graph.deviceManagementExchangeAccessState".



This property is on the "microsoft.graph.managedDevice" type.



The Access State of the device in Exchange.



Valid values: 'none', 'unknown', 'allowed', 'blocked', 'quarantined'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-exchangeAccessStateReason <string>

The "exchangeAccessStateReason" property, of type "microsoft.graph.deviceManagementExchangeAccessStateReason".



This property is on the "microsoft.graph.managedDevice" type.



The reason for the device's access state in Exchange.



Valid values: 'none', 'unknown', 'exchangeGlobalRule', 'exchangeIndividualRule', 'exchangeDeviceRule',

'exchangeUpgrade', 'exchangeMailboxPolicy', 'other', 'compliant', 'notCompliant', 'notEnrolled',

'unknownLocation', 'mfaRequired', 'azureADBlockDueToAccessPolicy', 'compromisedPassword',

'deviceNotKnownWithManagedApp'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-remoteAssistanceSessionUrl <string>

The "remoteAssistanceSessionUrl" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Url that allows a Remote Assistance session to be established with the device.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-remoteAssistanceSessionErrorDetails <string>

The "remoteAssistanceSessionErrorDetails" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



An error string that identifies issues when creating Remote Assistance session objects.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-isEncrypted <bool>

The "isEncrypted" property, of type "Edm.Boolean".



This property is on the "microsoft.graph.managedDevice" type.



Device encryption status



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-userPrincipalName <string>

The "userPrincipalName" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Device user principal name



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-model <string>

The "model" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Model of the device



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-manufacturer <string>

The "manufacturer" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Manufacturer of the device



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-imei <string>

The "imei" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



IMEI



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-complianceGracePeriodExpirationDateTime <DateTimeOffset>

The "complianceGracePeriodExpirationDateTime" property, of type "Edm.DateTimeOffset".



This property is on the "microsoft.graph.managedDevice" type.



The DateTime when device compliance grace period expires



Required? false

Position? named

Default value 1/1/0001 12:00:00 AM +00:00

Accept pipeline input? false

Accept wildcard characters? false



-serialNumber <string>

The "serialNumber" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



SerialNumber



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-phoneNumber <string>

The "phoneNumber" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Phone number of the device



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-androidSecurityPatchLevel <string>

The "androidSecurityPatchLevel" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Android security patch level



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-userDisplayName <string>

The "userDisplayName" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



User display name



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-configurationManagerClientEnabledFeatures <object>

The "configurationManagerClientEnabledFeatures" property, of type

"microsoft.graph.configurationManagerClientEnabledFeatures".



This property is on the "microsoft.graph.managedDevice" type.



ConfigrMgr client enabled features



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-wiFiMacAddress <string>

The "wiFiMacAddress" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Wi-Fi MAC



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceHealthAttestationState <object>

The "deviceHealthAttestationState" property, of type "microsoft.graph.deviceHealthAttestationState".



This property is on the "microsoft.graph.managedDevice" type.



The device health attestation state.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-subscriberCarrier <string>

The "subscriberCarrier" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Subscriber Carrier



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-meid <string>

The "meid" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



MEID



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-totalStorageSpaceInBytes <long>

The "totalStorageSpaceInBytes" property, of type "Edm.Int64".



This property is on the "microsoft.graph.managedDevice" type.



Total Storage in Bytes



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-freeStorageSpaceInBytes <long>

The "freeStorageSpaceInBytes" property, of type "Edm.Int64".



This property is on the "microsoft.graph.managedDevice" type.



Free Storage in Bytes



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-managedDeviceName <string>

The "managedDeviceName" property, of type "Edm.String".



This property is on the "microsoft.graph.managedDevice" type.



Automatically generated name to identify a device. Can be overwritten to a user friendly name.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-partnerReportedThreatState <string>

The "partnerReportedThreatState" property, of type "microsoft.graph.managedDevicePartnerReportedHealthState".



This property is on the "microsoft.graph.managedDevice" type.



Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and

device. Read Only.



Valid values: 'unknown', 'activated', 'deactivated', 'secured', 'lowSeverity', 'mediumSeverity',

'highSeverity', 'unresponsive', 'compromised', 'misconfigured'



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceConfigurationStates <object[]>

The "deviceConfigurationStates" property, of type "microsoft.graph.deviceConfigurationState".



This property is on the "microsoft.graph.managedDevice" type.



Device configuration states for this device.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceCategory <object>

The "deviceCategory" property, of type "microsoft.graph.deviceCategory".



This property is on the "microsoft.graph.managedDevice" type.



Device category



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-deviceCompliancePolicyStates <object[]>

The "deviceCompliancePolicyStates" property, of type "microsoft.graph.deviceCompliancePolicyState".



This property is on the "microsoft.graph.managedDevice" type.



Device compliance policy states for this device.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS





RELATED LINKS