Update-MgDeviceManagementDeviceConfiguration

Reference

Module:: Microsoft.Graph.DeviceManagement

Update the properties of a iosDeviceFeaturesConfiguration object.

Note

To view the beta release of this cmdlet, view Update-MgBetaDeviceManagementDeviceConfiguration

Syntax

Update-MgDeviceManagementDeviceConfiguration
      -DeviceConfigurationId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-Assignments <IMicrosoftGraphDeviceConfigurationAssignment[]>]
      [-CreatedDateTime <DateTime>]
      [-Description <String>]
      [-DeviceSettingStateSummaries <IMicrosoftGraphSettingStateDeviceSummary[]>]
      [-DeviceStatusOverview <IMicrosoftGraphDeviceConfigurationDeviceOverview>]
      [-DeviceStatuses <IMicrosoftGraphDeviceConfigurationDeviceStatus[]>]
      [-DisplayName <String>]
      [-Id <String>]
      [-LastModifiedDateTime <DateTime>]
      [-UserStatusOverview <IMicrosoftGraphDeviceConfigurationUserOverview>]
      [-UserStatuses <IMicrosoftGraphDeviceConfigurationUserStatus[]>]
      [-Version <Int32>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgDeviceManagementDeviceConfiguration
      -DeviceConfigurationId <String>
      -BodyParameter <IMicrosoftGraphDeviceConfiguration>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgDeviceManagementDeviceConfiguration
      -InputObject <IDeviceManagementIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-Assignments <IMicrosoftGraphDeviceConfigurationAssignment[]>]
      [-CreatedDateTime <DateTime>]
      [-Description <String>]
      [-DeviceSettingStateSummaries <IMicrosoftGraphSettingStateDeviceSummary[]>]
      [-DeviceStatusOverview <IMicrosoftGraphDeviceConfigurationDeviceOverview>]
      [-DeviceStatuses <IMicrosoftGraphDeviceConfigurationDeviceStatus[]>]
      [-DisplayName <String>]
      [-Id <String>]
      [-LastModifiedDateTime <DateTime>]
      [-UserStatusOverview <IMicrosoftGraphDeviceConfigurationUserOverview>]
      [-UserStatuses <IMicrosoftGraphDeviceConfigurationUserStatus[]>]
      [-Version <Int32>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgDeviceManagementDeviceConfiguration
      -InputObject <IDeviceManagementIdentity>
      -BodyParameter <IMicrosoftGraphDeviceConfiguration>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the properties of a iosDeviceFeaturesConfiguration object.

Parameters

-AdditionalProperties

Additional Parameters

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

-Assignments

The list of assignments for the device configuration profile. To construct, see NOTES section for ASSIGNMENTS properties and create a hash table.

Type:	IMicrosoftGraphDeviceConfigurationAssignment[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BodyParameter

Device Configuration. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Type:	IMicrosoftGraphDeviceConfiguration
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

-CreatedDateTime

DateTime the object was created.

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

-Description

Admin provided description of the Device Configuration.

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

-DeviceConfigurationId

The unique identifier of deviceConfiguration

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

-DeviceSettingStateSummaries

Device Configuration Setting State Device Summary To construct, see NOTES section for DEVICESETTINGSTATESUMMARIES properties and create a hash table.

Type:	IMicrosoftGraphSettingStateDeviceSummary[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceStatuses

Device configuration installation status by device. To construct, see NOTES section for DEVICESTATUSES properties and create a hash table.

Type:	IMicrosoftGraphDeviceConfigurationDeviceStatus[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceStatusOverview

deviceConfigurationDeviceOverview To construct, see NOTES section for DEVICESTATUSOVERVIEW properties and create a hash table.

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

-DisplayName

Admin provided name of the device configuration.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-LastModifiedDateTime

DateTime the object was last modified.

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

-ProgressAction

Type:	ActionPreference
Aliases:	proga
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

-UserStatuses

Device configuration installation status by user. To construct, see NOTES section for USERSTATUSES properties and create a hash table.

Type:	IMicrosoftGraphDeviceConfigurationUserStatus[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserStatusOverview

deviceConfigurationUserOverview To construct, see NOTES section for USERSTATUSOVERVIEW properties and create a hash table.

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

-Version

Version of the device configuration.

Type:	Int32
Position:	Named
Default value:	0
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.IDeviceManagementIdentity

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceConfiguration

System.Collections.IDictionary

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceConfiguration

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.

ASSIGNMENTS <IMicrosoftGraphDeviceConfigurationAssignment- []>: The list of assignments for the device configuration profile.

[Id <String>]: The unique identifier for an entity. Read-only.
[Target <IMicrosoftGraphDeviceAndAppManagementAssignmentTarget>]: Base type for assignment targets.
- [(Any) <Object>]: This indicates any property can be added to this object.

BODYPARAMETER <IMicrosoftGraphDeviceConfiguration>: Device Configuration.

[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity. Read-only.
[Assignments <IMicrosoftGraphDeviceConfigurationAssignment- []>]: The list of assignments for the device configuration profile.
- [Id <String>]: The unique identifier for an entity. Read-only.
- [Target <IMicrosoftGraphDeviceAndAppManagementAssignmentTarget>]: Base type for assignment targets.
  - [(Any) <Object>]: This indicates any property can be added to this object.
[CreatedDateTime <DateTime?>]: DateTime the object was created.
[Description <String>]: Admin provided description of the Device Configuration.
[DeviceSettingStateSummaries <IMicrosoftGraphSettingStateDeviceSummary- []>]: Device Configuration Setting State Device Summary
- [Id <String>]: The unique identifier for an entity. Read-only.
- [CompliantDeviceCount <Int32?>]: Device Compliant count for the setting
- [ConflictDeviceCount <Int32?>]: Device conflict error count for the setting
- [ErrorDeviceCount <Int32?>]: Device error count for the setting
- [InstancePath <String>]: Name of the InstancePath for the setting
- [NonCompliantDeviceCount <Int32?>]: Device NonCompliant count for the setting
- [NotApplicableDeviceCount <Int32?>]: Device Not Applicable count for the setting
- [RemediatedDeviceCount <Int32?>]: Device Compliant count for the setting
- [SettingName <String>]: Name of the setting
- [UnknownDeviceCount <Int32?>]: Device Unkown count for the setting
[DeviceStatusOverview <IMicrosoftGraphDeviceConfigurationDeviceOverview>]: deviceConfigurationDeviceOverview
- [(Any) <Object>]: This indicates any property can be added to this object.
- [Id <String>]: The unique identifier for an entity. Read-only.
- [ConfigurationVersion <Int32?>]: Version of the policy for that overview
- [ErrorCount <Int32?>]: Number of error devices
- [FailedCount <Int32?>]: Number of failed devices
- [LastUpdateDateTime <DateTime?>]: Last update time
- [NotApplicableCount <Int32?>]: Number of not applicable devices
- [PendingCount <Int32?>]: Number of pending devices
- [SuccessCount <Int32?>]: Number of succeeded devices
[DeviceStatuses <IMicrosoftGraphDeviceConfigurationDeviceStatus- []>]: Device configuration installation status by device.
- [Id <String>]: The unique identifier for an entity. Read-only.
- [ComplianceGracePeriodExpirationDateTime <DateTime?>]: The DateTime when device compliance grace period expires
- [DeviceDisplayName <String>]: Device name of the DevicePolicyStatus.
- [DeviceModel <String>]: The device model that is being reported
- [LastReportedDateTime <DateTime?>]: Last modified date time of the policy report.
- [Status <String>]: complianceStatus
- [UserName <String>]: The User Name that is being reported
- [UserPrincipalName <String>]: UserPrincipalName.
[DisplayName <String>]: Admin provided name of the device configuration.
[LastModifiedDateTime <DateTime?>]: DateTime the object was last modified.
[UserStatusOverview <IMicrosoftGraphDeviceConfigurationUserOverview>]: deviceConfigurationUserOverview
- [(Any) <Object>]: This indicates any property can be added to this object.
- [Id <String>]: The unique identifier for an entity. Read-only.
- [ConfigurationVersion <Int32?>]: Version of the policy for that overview
- [ErrorCount <Int32?>]: Number of error Users
- [FailedCount <Int32?>]: Number of failed Users
- [LastUpdateDateTime <DateTime?>]: Last update time
- [NotApplicableCount <Int32?>]: Number of not applicable users
- [PendingCount <Int32?>]: Number of pending Users
- [SuccessCount <Int32?>]: Number of succeeded Users
[UserStatuses <IMicrosoftGraphDeviceConfigurationUserStatus- []>]: Device configuration installation status by user.
- [Id <String>]: The unique identifier for an entity. Read-only.
- [DevicesCount <Int32?>]: Devices count for that user.
- [LastReportedDateTime <DateTime?>]: Last modified date time of the policy report.
- [Status <String>]: complianceStatus
- [UserDisplayName <String>]: User name of the DevicePolicyStatus.
- [UserPrincipalName <String>]: UserPrincipalName.
[Version <Int32?>]: Version of the device configuration.

DEVICESETTINGSTATESUMMARIES <IMicrosoftGraphSettingStateDeviceSummary- []>: Device Configuration Setting State Device Summary

[Id <String>]: The unique identifier for an entity. Read-only.
[CompliantDeviceCount <Int32?>]: Device Compliant count for the setting
[ConflictDeviceCount <Int32?>]: Device conflict error count for the setting
[ErrorDeviceCount <Int32?>]: Device error count for the setting
[InstancePath <String>]: Name of the InstancePath for the setting
[NonCompliantDeviceCount <Int32?>]: Device NonCompliant count for the setting
[NotApplicableDeviceCount <Int32?>]: Device Not Applicable count for the setting
[RemediatedDeviceCount <Int32?>]: Device Compliant count for the setting
[SettingName <String>]: Name of the setting
[UnknownDeviceCount <Int32?>]: Device Unkown count for the setting

DEVICESTATUSES <IMicrosoftGraphDeviceConfigurationDeviceStatus- []>: Device configuration installation status by device.

[Id <String>]: The unique identifier for an entity. Read-only.
[ComplianceGracePeriodExpirationDateTime <DateTime?>]: The DateTime when device compliance grace period expires
[DeviceDisplayName <String>]: Device name of the DevicePolicyStatus.
[DeviceModel <String>]: The device model that is being reported
[LastReportedDateTime <DateTime?>]: Last modified date time of the policy report.
[Status <String>]: complianceStatus
[UserName <String>]: The User Name that is being reported
[UserPrincipalName <String>]: UserPrincipalName.

DEVICESTATUSOVERVIEW <IMicrosoftGraphDeviceConfigurationDeviceOverview>: deviceConfigurationDeviceOverview

[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity. Read-only.
[ConfigurationVersion <Int32?>]: Version of the policy for that overview
[ErrorCount <Int32?>]: Number of error devices
[FailedCount <Int32?>]: Number of failed devices
[LastUpdateDateTime <DateTime?>]: Last update time
[NotApplicableCount <Int32?>]: Number of not applicable devices
[PendingCount <Int32?>]: Number of pending devices
[SuccessCount <Int32?>]: Number of succeeded devices

INPUTOBJECT <IDeviceManagementIdentity>: Identity Parameter

[AppLogCollectionRequestId <String>]: The unique identifier of appLogCollectionRequest
[BrowserSharedCookieId <String>]: The unique identifier of browserSharedCookie
[BrowserSiteId <String>]: The unique identifier of browserSite
[BrowserSiteListId <String>]: The unique identifier of browserSiteList
[DetectedAppId <String>]: The unique identifier of detectedApp
[DeviceCategoryId <String>]: The unique identifier of deviceCategory
[DeviceComplianceActionItemId <String>]: The unique identifier of deviceComplianceActionItem
[DeviceComplianceDeviceStatusId <String>]: The unique identifier of deviceComplianceDeviceStatus
[DeviceCompliancePolicyAssignmentId <String>]: The unique identifier of deviceCompliancePolicyAssignment
[DeviceCompliancePolicyId <String>]: The unique identifier of deviceCompliancePolicy
[DeviceCompliancePolicySettingStateSummaryId <String>]: The unique identifier of deviceCompliancePolicySettingStateSummary
[DeviceCompliancePolicyStateId <String>]: The unique identifier of deviceCompliancePolicyState
[DeviceComplianceScheduledActionForRuleId <String>]: The unique identifier of deviceComplianceScheduledActionForRule
[DeviceComplianceSettingStateId <String>]: The unique identifier of deviceComplianceSettingState
[DeviceComplianceUserStatusId <String>]: The unique identifier of deviceComplianceUserStatus
[DeviceConfigurationAssignmentId <String>]: The unique identifier of deviceConfigurationAssignment
[DeviceConfigurationDeviceStatusId <String>]: The unique identifier of deviceConfigurationDeviceStatus
[DeviceConfigurationId <String>]: The unique identifier of deviceConfiguration
[DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState
[DeviceConfigurationUserStatusId <String>]: The unique identifier of deviceConfigurationUserStatus
[DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse
[DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent
[LocalizedNotificationMessageId <String>]: The unique identifier of localizedNotificationMessage
[MalwareStateForWindowsDeviceId <String>]: The unique identifier of malwareStateForWindowsDevice
[ManagedDeviceId <String>]: The unique identifier of managedDevice
[MobileAppTroubleshootingEventId <String>]: The unique identifier of mobileAppTroubleshootingEvent
[NotificationMessageTemplateId <String>]: The unique identifier of notificationMessageTemplate
[SettingStateDeviceSummaryId <String>]: The unique identifier of settingStateDeviceSummary
[UserExperienceAnalyticsAppHealthAppPerformanceByAppVersionDetailsId <String>]: The unique identifier of userExperienceAnalyticsAppHealthAppPerformanceByAppVersionDetails
[UserExperienceAnalyticsAppHealthAppPerformanceByAppVersionDeviceId <String>]: The unique identifier of userExperienceAnalyticsAppHealthAppPerformanceByAppVersionDeviceId
[UserExperienceAnalyticsAppHealthAppPerformanceByOSVersionId <String>]: The unique identifier of userExperienceAnalyticsAppHealthAppPerformanceByOSVersion
[UserExperienceAnalyticsAppHealthApplicationPerformanceId <String>]: The unique identifier of userExperienceAnalyticsAppHealthApplicationPerformance
[UserExperienceAnalyticsAppHealthDeviceModelPerformanceId <String>]: The unique identifier of userExperienceAnalyticsAppHealthDeviceModelPerformance
[UserExperienceAnalyticsAppHealthDevicePerformanceDetailsId <String>]: The unique identifier of userExperienceAnalyticsAppHealthDevicePerformanceDetails
[UserExperienceAnalyticsAppHealthDevicePerformanceId <String>]: The unique identifier of userExperienceAnalyticsAppHealthDevicePerformance
[UserExperienceAnalyticsAppHealthOSVersionPerformanceId <String>]: The unique identifier of userExperienceAnalyticsAppHealthOSVersionPerformance
[UserExperienceAnalyticsBaselineId <String>]: The unique identifier of userExperienceAnalyticsBaseline
[UserExperienceAnalyticsCategoryId <String>]: The unique identifier of userExperienceAnalyticsCategory
[UserExperienceAnalyticsDevicePerformanceId <String>]: The unique identifier of userExperienceAnalyticsDevicePerformance
[UserExperienceAnalyticsDeviceScoresId <String>]: The unique identifier of userExperienceAnalyticsDeviceScores
[UserExperienceAnalyticsDeviceStartupHistoryId <String>]: The unique identifier of userExperienceAnalyticsDeviceStartupHistory
[UserExperienceAnalyticsDeviceStartupProcessId <String>]: The unique identifier of userExperienceAnalyticsDeviceStartupProcess
[UserExperienceAnalyticsDeviceStartupProcessPerformanceId <String>]: The unique identifier of userExperienceAnalyticsDeviceStartupProcessPerformance
[UserExperienceAnalyticsMetricHistoryId <String>]: The unique identifier of userExperienceAnalyticsMetricHistory
[UserExperienceAnalyticsMetricId <String>]: The unique identifier of userExperienceAnalyticsMetric
[UserExperienceAnalyticsModelScoresId <String>]: The unique identifier of userExperienceAnalyticsModelScores
[UserExperienceAnalyticsScoreHistoryId <String>]: The unique identifier of userExperienceAnalyticsScoreHistory
[UserExperienceAnalyticsWorkFromAnywhereDeviceId <String>]: The unique identifier of userExperienceAnalyticsWorkFromAnywhereDevice
[UserExperienceAnalyticsWorkFromAnywhereMetricId <String>]: The unique identifier of userExperienceAnalyticsWorkFromAnywhereMetric
[UserExperienceAnalyticsWorkFromAnywhereModelPerformanceId <String>]: The unique identifier of userExperienceAnalyticsWorkFromAnywhereModelPerformance
[WindowsDeviceMalwareStateId <String>]: The unique identifier of windowsDeviceMalwareState
[WindowsInformationProtectionAppLearningSummaryId <String>]: The unique identifier of windowsInformationProtectionAppLearningSummary
[WindowsInformationProtectionNetworkLearningSummaryId <String>]: The unique identifier of windowsInformationProtectionNetworkLearningSummary
[WindowsMalwareInformationId <String>]: The unique identifier of windowsMalwareInformation

USERSTATUSES <IMicrosoftGraphDeviceConfigurationUserStatus- []>: Device configuration installation status by user.

[Id <String>]: The unique identifier for an entity. Read-only.
[DevicesCount <Int32?>]: Devices count for that user.
[LastReportedDateTime <DateTime?>]: Last modified date time of the policy report.
[Status <String>]: complianceStatus
[UserDisplayName <String>]: User name of the DevicePolicyStatus.
[UserPrincipalName <String>]: UserPrincipalName.

USERSTATUSOVERVIEW <IMicrosoftGraphDeviceConfigurationUserOverview>: deviceConfigurationUserOverview

[(Any) <Object>]: This indicates any property can be added to this object.
[Id <String>]: The unique identifier for an entity. Read-only.
[ConfigurationVersion <Int32?>]: Version of the policy for that overview
[ErrorCount <Int32?>]: Number of error Users
[FailedCount <Int32?>]: Number of failed Users
[LastUpdateDateTime <DateTime?>]: Last update time
[NotApplicableCount <Int32?>]: Number of not applicable users
[PendingCount <Int32?>]: Number of pending Users
[SuccessCount <Int32?>]: Number of succeeded Users

https://learn.microsoft.com/powershell/module/microsoft.graph.devicemanagement/update-mgdevicemanagementdeviceconfiguration

https://learn.microsoft.com/graph/api/intune-deviceconfig-iosdevicefeaturesconfiguration-update?view=graph-rest-1.0

Share via

Update-MgDeviceManagementDeviceConfiguration

Syntax

Description

Parameters

-AdditionalProperties

-Assignments

-BodyParameter

-Confirm

-CreatedDateTime

-Description

-DeviceConfigurationId

-DeviceSettingStateSummaries

-DeviceStatuses

-DeviceStatusOverview

-DisplayName

-Headers

-Id

-InputObject

-LastModifiedDateTime

-ProgressAction

-ResponseHeadersVariable

-UserStatuses

-UserStatusOverview

-Version

-WhatIf

Inputs

Outputs

Notes

Additional resources

Share via

Update-MgDeviceManagementDeviceConfiguration

Syntax

Description

Parameters

-AdditionalProperties

-Assignments

-BodyParameter

-Confirm

-CreatedDateTime

-Description

-DeviceConfigurationId

-DeviceSettingStateSummaries

-DeviceStatuses

-DeviceStatusOverview

-DisplayName

-Headers

-Id

-InputObject

-LastModifiedDateTime

-ProgressAction

-ResponseHeadersVariable

-UserStatuses

-UserStatusOverview

-Version

-WhatIf

Inputs

Outputs

Notes

RELATED LINKS

Additional resources