< Back
Update-DeviceManagement_ManagedDevices
Post
NAME Update-DeviceManagement_ManagedDevices
SYNOPSIS
Updates a "microsoft.graph.managedDevice".
SYNTAX
Update-DeviceManagement_ManagedDevices -managedDeviceId <string> [-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>]
Update-DeviceManagement_ManagedDevices -managedDeviceId <string> -ODataType <string> [-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
Updates a "microsoft.graph.managedDevice" object in the "managedDevices" collection.
The list of managed devices.
Graph Call: PATCH ~/deviceManagement/managedDevices
PARAMETERS
-managedDeviceId <string>
The ID for a "microsoft.graph.managedDevice" object in the "managedDevices" collection.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-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
-ODataType <string>
The value provided in a search result (i.e. GET on a collection) in the "@odata.type" property.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-@odata.type <string>
The value provided in a search result (i.e. GET on a collection) in the "@odata.type" property.
This is an alias of the ODataType parameter.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
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
System.String
The ID for a "microsoft.graph.managedDevice" object in the "managedDevices" collection.
System.String
The value provided in a search result (i.e. GET on a collection) in the "@odata.type" property.
OUTPUTS
RELATED LINKS
GitHub Repository https://github.com/Microsoft/Intune-PowerShell-SDK
SYNOPSIS
Updates a "microsoft.graph.managedDevice".
SYNTAX
Update-DeviceManagement_ManagedDevices -managedDeviceId <string> [-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>]
Update-DeviceManagement_ManagedDevices -managedDeviceId <string> -ODataType <string> [-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
Updates a "microsoft.graph.managedDevice" object in the "managedDevices" collection.
The list of managed devices.
Graph Call: PATCH ~/deviceManagement/managedDevices
PARAMETERS
-managedDeviceId <string>
The ID for a "microsoft.graph.managedDevice" object in the "managedDevices" collection.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-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
-ODataType <string>
The value provided in a search result (i.e. GET on a collection) in the "@odata.type" property.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-@odata.type <string>
The value provided in a search result (i.e. GET on a collection) in the "@odata.type" property.
This is an alias of the ODataType parameter.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
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
System.String
The ID for a "microsoft.graph.managedDevice" object in the "managedDevices" collection.
System.String
The value provided in a search result (i.e. GET on a collection) in the "@odata.type" property.
OUTPUTS
RELATED LINKS
GitHub Repository https://github.com/Microsoft/Intune-PowerShell-SDK