| external help file | Module Name | online version | schema | ms.subservice |
|---|---|---|---|---|
Microsoft.Graph.DeviceManagement-help.xml |
Microsoft.Graph.DeviceManagement |
2.0.0 |
intune |
Update the properties of a windows10SecureAssessmentConfiguration object.
Note
To view the beta release of this cmdlet, view Update-MgBetaDeviceManagementDeviceConfiguration
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>]
Update the properties of a windows10SecureAssessmentConfiguration object.
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.sharedPCConfiguration"
description = "Description value"
displayName = "Display Name value"
version = 7
accountManagerPolicy = @{
"@odata.type" = "microsoft.graph.sharedPCAccountManagerPolicy"
accountDeletionPolicy = "diskSpaceThreshold"
cacheAccountsAboveDiskFreePercentage =
inactiveThresholdDays =
removeAccountsBelowDiskFreePercentage =
}
allowedAccounts = "domain"
allowLocalStorage = $true
disableAccountManager = $true
disableEduPolicies = $true
disablePowerPolicies = $true
disableSignInOnResume = $true
enabled = $true
idleTimeBeforeSleepInSeconds =
kioskAppDisplayName = "Kiosk App Display Name value"
kioskAppUserModelId = "Kiosk App User Model Id value"
maintenanceStartTime = "11:59:24.7240000"
}
Update-MgDeviceManagementDeviceConfiguration -DeviceConfigurationId $deviceConfigurationId -BodyParameter $params
This example shows how to use the Update-MgDeviceManagementDeviceConfiguration Cmdlet.
Additional Parameters
Type: Hashtable
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe list of assignments for the device configuration profile. To construct, see NOTES section for ASSIGNMENTS properties and create a hash table.
Type: IMicrosoftGraphDeviceConfigurationAssignment[]
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseDevice Configuration. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Type: IMicrosoftGraphDeviceConfiguration
Parameter Sets: Update, UpdateViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseDateTime the object was created.
Type: DateTime
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseAdmin provided description of the Device Configuration.
Type: String
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe unique identifier of deviceConfiguration
Type: String
Parameter Sets: UpdateExpanded, Update
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseDevice Configuration Setting State Device Summary To construct, see NOTES section for DEVICESETTINGSTATESUMMARIES properties and create a hash table.
Type: IMicrosoftGraphSettingStateDeviceSummary[]
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseDevice configuration installation status by device. To construct, see NOTES section for DEVICESTATUSES properties and create a hash table.
Type: IMicrosoftGraphDeviceConfigurationDeviceStatus[]
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsedeviceConfigurationDeviceOverview To construct, see NOTES section for DEVICESTATUSOVERVIEW properties and create a hash table.
Type: IMicrosoftGraphDeviceConfigurationDeviceOverview
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseAdmin provided name of the device configuration.
Type: String
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseOptional headers that will be added to the request.
Type: IDictionary
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseThe unique identifier for an entity. Read-only.
Type: String
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseIdentity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Type: IDeviceManagementIdentity
Parameter Sets: UpdateViaIdentityExpanded, UpdateViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseDateTime the object was last modified.
Type: DateTime
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseOptional Response Headers Variable.
Type: String
Parameter Sets: (All)
Aliases: RHV
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseDevice configuration installation status by user. To construct, see NOTES section for USERSTATUSES properties and create a hash table.
Type: IMicrosoftGraphDeviceConfigurationUserStatus[]
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsedeviceConfigurationUserOverview To construct, see NOTES section for USERSTATUSOVERVIEW properties and create a hash table.
Type: IMicrosoftGraphDeviceConfigurationUserOverview
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseVersion of the device configuration.
Type: Int32
Parameter Sets: UpdateExpanded, UpdateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: FalsePrompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseShows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
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