Update-MgBetaDeviceManagementDeviceCategory

Update the navigation property deviceCategories in deviceManagement

Note

To view the v1.0 release of this cmdlet, view Update-MgDeviceManagementDeviceCategory

Syntax

Update-MgBetaDeviceManagementDeviceCategory
      -DeviceCategoryId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-Description <String>]
      [-DisplayName <String>]
      [-Id <String>]
      [-RoleScopeTagIds <String[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceManagementDeviceCategory
      -DeviceCategoryId <String>
      -BodyParameter <IMicrosoftGraphDeviceCategory>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceManagementDeviceCategory
      -InputObject <IDeviceManagementIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-Description <String>]
      [-DisplayName <String>]
      [-Id <String>]
      [-RoleScopeTagIds <String[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceManagementDeviceCategory
      -InputObject <IDeviceManagementIdentity>
      -BodyParameter <IMicrosoftGraphDeviceCategory>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the navigation property deviceCategories in deviceManagement

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

Device categories provides a way to organize your devices. Using device categories, company administrators can define their own categories that make sense to their company. These categories can then be applied to a device in the Intune Azure console or selected by a user during device enrollment. You can filter reports and create dynamic Azure Active Directory device groups based on device categories. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Description

Optional description for the device category.

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

-DeviceCategoryId

The unique identifier of deviceCategory

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

-DisplayName

Display name for the device category.

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

-ProgressAction

{{ Fill ProgressAction Description }}

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

-RoleScopeTagIds

Optional role scope tags for the device category.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IDeviceManagementIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceCategory

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceCategory

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IMicrosoftGraphDeviceCategory>: Device categories provides a way to organize your devices. Using device categories, company administrators can define their own categories that make sense to their company. These categories can then be applied to a device in the Intune Azure console or selected by a user during device enrollment. You can filter reports and create dynamic Azure Active Directory device groups based on device categories.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Description <String>]: Optional description for the device category.
  • [DisplayName <String>]: Display name for the device category.
  • [RoleScopeTagIds <String- []>]: Optional role scope tags for the device category.

INPUTOBJECT <IDeviceManagementIdentity>: Identity Parameter

  • [AdvancedThreatProtectionOnboardingDeviceSettingStateId <String>]: The unique identifier of advancedThreatProtectionOnboardingDeviceSettingState
  • [AlertRecordId <String>]: The unique identifier of alertRecord
  • [AlertRuleId <String>]: The unique identifier of alertRule
  • [AndroidForWorkAppConfigurationSchemaId <String>]: The unique identifier of androidForWorkAppConfigurationSchema
  • [AndroidManagedStoreAppConfigurationSchemaId <String>]: The unique identifier of androidManagedStoreAppConfigurationSchema
  • [AppLogCollectionRequestId <String>]: The unique identifier of appLogCollectionRequest
  • [AssignmentFilterEvaluationStatusDetailsId <String>]: The unique identifier of assignmentFilterEvaluationStatusDetails
  • [BrowserSharedCookieId <String>]: The unique identifier of browserSharedCookie
  • [BrowserSiteId <String>]: The unique identifier of browserSite
  • [BrowserSiteListId <String>]: The unique identifier of browserSiteList
  • [DataSharingConsentId <String>]: The unique identifier of dataSharingConsent
  • [DetectedAppId <String>]: The unique identifier of detectedApp
  • [DeviceAndAppManagementAssignmentFilterId <String>]: The unique identifier of deviceAndAppManagementAssignmentFilter
  • [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
  • [DeviceConfigurationConflictSummaryId <String>]: The unique identifier of deviceConfigurationConflictSummary
  • [DeviceConfigurationDeviceStatusId <String>]: The unique identifier of deviceConfigurationDeviceStatus
  • [DeviceConfigurationGroupAssignmentId <String>]: The unique identifier of deviceConfigurationGroupAssignment
  • [DeviceConfigurationId <String>]: The unique identifier of deviceConfiguration
  • [DeviceConfigurationProfileId <String>]: The unique identifier of deviceConfigurationProfile
  • [DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState
  • [DeviceConfigurationUserStatusId <String>]: The unique identifier of deviceConfigurationUserStatus
  • [DeviceHealthScriptAssignmentId <String>]: The unique identifier of deviceHealthScriptAssignment
  • [DeviceHealthScriptDeviceStateId <String>]: The unique identifier of deviceHealthScriptDeviceState
  • [DeviceHealthScriptId <String>]: The unique identifier of deviceHealthScript
  • [DeviceId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse
  • [DeviceManagementComplianceActionItemId <String>]: The unique identifier of deviceManagementComplianceActionItem
  • [DeviceManagementCompliancePolicyId <String>]: The unique identifier of deviceManagementCompliancePolicy
  • [DeviceManagementComplianceScheduledActionForRuleId <String>]: The unique identifier of deviceManagementComplianceScheduledActionForRule
  • [DeviceManagementConfigurationPolicyAssignmentId <String>]: The unique identifier of deviceManagementConfigurationPolicyAssignment
  • [DeviceManagementConfigurationPolicyId <String>]: The unique identifier of deviceManagementConfigurationPolicy
  • [DeviceManagementConfigurationPolicyTemplateId <String>]: The unique identifier of deviceManagementConfigurationPolicyTemplate
  • [DeviceManagementConfigurationSettingDefinitionId <String>]: The unique identifier of deviceManagementConfigurationSettingDefinition
  • [DeviceManagementConfigurationSettingId <String>]: The unique identifier of deviceManagementConfigurationSetting
  • [DeviceManagementConfigurationSettingTemplateId <String>]: The unique identifier of deviceManagementConfigurationSettingTemplate
  • [DeviceManagementDerivedCredentialSettingsId <String>]: The unique identifier of deviceManagementDerivedCredentialSettings
  • [DeviceManagementIntentAssignmentId <String>]: The unique identifier of deviceManagementIntentAssignment
  • [DeviceManagementIntentDeviceSettingStateSummaryId <String>]: The unique identifier of deviceManagementIntentDeviceSettingStateSummary
  • [DeviceManagementIntentDeviceStateId <String>]: The unique identifier of deviceManagementIntentDeviceState
  • [DeviceManagementIntentId <String>]: The unique identifier of deviceManagementIntent
  • [DeviceManagementIntentSettingCategoryId <String>]: The unique identifier of deviceManagementIntentSettingCategory
  • [DeviceManagementIntentUserStateId <String>]: The unique identifier of deviceManagementIntentUserState
  • [DeviceManagementResourceAccessProfileAssignmentId <String>]: The unique identifier of deviceManagementResourceAccessProfileAssignment
  • [DeviceManagementResourceAccessProfileBaseId <String>]: The unique identifier of deviceManagementResourceAccessProfileBase
  • [DeviceManagementScriptAssignmentId <String>]: The unique identifier of deviceManagementScriptAssignment
  • [DeviceManagementScriptDeviceStateId <String>]: The unique identifier of deviceManagementScriptDeviceState
  • [DeviceManagementScriptGroupAssignmentId <String>]: The unique identifier of deviceManagementScriptGroupAssignment
  • [DeviceManagementScriptId <String>]: The unique identifier of deviceManagementScript
  • [DeviceManagementScriptUserStateId <String>]: The unique identifier of deviceManagementScriptUserState
  • [DeviceManagementSettingCategoryId <String>]: The unique identifier of deviceManagementSettingCategory
  • [DeviceManagementSettingDefinitionId <String>]: The unique identifier of deviceManagementSettingDefinition
  • [DeviceManagementSettingInstanceId <String>]: The unique identifier of deviceManagementSettingInstance
  • [DeviceManagementTemplateId <String>]: The unique identifier of deviceManagementTemplate
  • [DeviceManagementTemplateId1 <String>]: The unique identifier of deviceManagementTemplate
  • [DeviceManagementTemplateSettingCategoryId <String>]: The unique identifier of deviceManagementTemplateSettingCategory
  • [DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent
  • [DeviceShellScriptId <String>]: The unique identifier of deviceShellScript
  • [EmbeddedSimActivationCodePoolAssignmentId <String>]: The unique identifier of embeddedSIMActivationCodePoolAssignment
  • [EmbeddedSimActivationCodePoolId <String>]: The unique identifier of embeddedSIMActivationCodePool
  • [EmbeddedSimDeviceStateId <String>]: The unique identifier of embeddedSIMDeviceState
  • [GroupPolicyConfigurationAssignmentId <String>]: The unique identifier of groupPolicyConfigurationAssignment
  • [GroupPolicyConfigurationId <String>]: The unique identifier of groupPolicyConfiguration
  • [GroupPolicyDefinitionValueId <String>]: The unique identifier of groupPolicyDefinitionValue
  • [GroupPolicyPresentationValueId <String>]: The unique identifier of groupPolicyPresentationValue
  • [Id <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [LocalizedNotificationMessageId <String>]: The unique identifier of localizedNotificationMessage
  • [MacOSSoftwareUpdateAccountSummaryId <String>]: The unique identifier of macOSSoftwareUpdateAccountSummary
  • [MacOSSoftwareUpdateCategorySummaryId <String>]: The unique identifier of macOSSoftwareUpdateCategorySummary
  • [MacOSSoftwareUpdateStateSummaryId <String>]: The unique identifier of macOSSoftwareUpdateStateSummary
  • [MalwareStateForWindowsDeviceId <String>]: The unique identifier of malwareStateForWindowsDevice
  • [ManagedDeviceCleanupRuleId <String>]: The unique identifier of managedDeviceCleanupRule
  • [ManagedDeviceEncryptionStateId <String>]: The unique identifier of managedDeviceEncryptionState
  • [ManagedDeviceId <String>]: The unique identifier of managedDevice
  • [ManagedDeviceMobileAppConfigurationStateId <String>]: The unique identifier of managedDeviceMobileAppConfigurationState
  • [ManagedDeviceWindowsOperatingSystemImageId <String>]: The unique identifier of managedDeviceWindowsOperatingSystemImage
  • [MicrosoftTunnelConfigurationId <String>]: The unique identifier of microsoftTunnelConfiguration
  • [MicrosoftTunnelHealthThresholdId <String>]: The unique identifier of microsoftTunnelHealthThreshold
  • [MicrosoftTunnelServerId <String>]: The unique identifier of microsoftTunnelServer
  • [MicrosoftTunnelServerLogCollectionResponseId <String>]: The unique identifier of microsoftTunnelServerLogCollectionResponse
  • [MicrosoftTunnelSiteId <String>]: The unique identifier of microsoftTunnelSite
  • [MobileAppTroubleshootingEventId <String>]: The unique identifier of mobileAppTroubleshootingEvent
  • [NotificationMessageTemplateId <String>]: The unique identifier of notificationMessageTemplate
  • [PolicyId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [RemoteActionAuditId <String>]: The unique identifier of remoteActionAudit
  • [SecurityBaselineSettingStateId <String>]: The unique identifier of securityBaselineSettingState
  • [SecurityBaselineStateId <String>]: The unique identifier of securityBaselineState
  • [SettingStateDeviceSummaryId <String>]: The unique identifier of settingStateDeviceSummary
  • [UserExperienceAnalyticsAnomalyCorrelationGroupOverviewId <String>]: The unique identifier of userExperienceAnalyticsAnomalyCorrelationGroupOverview
  • [UserExperienceAnalyticsAnomalyDeviceId <String>]: The unique identifier of userExperienceAnalyticsAnomalyDevice
  • [UserExperienceAnalyticsAnomalyId <String>]: The unique identifier of userExperienceAnalyticsAnomaly
  • [UserExperienceAnalyticsAppHealthAppPerformanceByAppVersionDetailsId <String>]: The unique identifier of userExperienceAnalyticsAppHealthAppPerformanceByAppVersionDetails
  • [UserExperienceAnalyticsAppHealthAppPerformanceByAppVersionDeviceId <String>]: The unique identifier of userExperienceAnalyticsAppHealthAppPerformanceByAppVersionDeviceId
  • [UserExperienceAnalyticsAppHealthAppPerformanceByAppVersionId <String>]: The unique identifier of userExperienceAnalyticsAppHealthAppPerformanceByAppVersion
  • [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
  • [UserExperienceAnalyticsBatteryHealthAppImpactId <String>]: The unique identifier of userExperienceAnalyticsBatteryHealthAppImpact
  • [UserExperienceAnalyticsBatteryHealthDeviceAppImpactId <String>]: The unique identifier of userExperienceAnalyticsBatteryHealthDeviceAppImpact
  • [UserExperienceAnalyticsBatteryHealthDevicePerformanceId <String>]: The unique identifier of userExperienceAnalyticsBatteryHealthDevicePerformance
  • [UserExperienceAnalyticsBatteryHealthDeviceRuntimeHistoryId <String>]: The unique identifier of userExperienceAnalyticsBatteryHealthDeviceRuntimeHistory
  • [UserExperienceAnalyticsBatteryHealthModelPerformanceId <String>]: The unique identifier of userExperienceAnalyticsBatteryHealthModelPerformance
  • [UserExperienceAnalyticsBatteryHealthOSPerformanceId <String>]: The unique identifier of userExperienceAnalyticsBatteryHealthOsPerformance
  • [UserExperienceAnalyticsCategoryId <String>]: The unique identifier of userExperienceAnalyticsCategory
  • [UserExperienceAnalyticsDevicePerformanceId <String>]: The unique identifier of userExperienceAnalyticsDevicePerformance
  • [UserExperienceAnalyticsDeviceScopeId <String>]: The unique identifier of userExperienceAnalyticsDeviceScope
  • [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
  • [UserExperienceAnalyticsDeviceTimelineEventId <String>]: The unique identifier of userExperienceAnalyticsDeviceTimelineEvent
  • [UserExperienceAnalyticsDeviceWithoutCloudIdentityId <String>]: The unique identifier of userExperienceAnalyticsDeviceWithoutCloudIdentity
  • [UserExperienceAnalyticsImpactingProcessId <String>]: The unique identifier of userExperienceAnalyticsImpactingProcess
  • [UserExperienceAnalyticsMetricHistoryId <String>]: The unique identifier of userExperienceAnalyticsMetricHistory
  • [UserExperienceAnalyticsMetricId <String>]: The unique identifier of userExperienceAnalyticsMetric
  • [UserExperienceAnalyticsModelScoresId <String>]: The unique identifier of userExperienceAnalyticsModelScores
  • [UserExperienceAnalyticsNotAutopilotReadyDeviceId <String>]: The unique identifier of userExperienceAnalyticsNotAutopilotReadyDevice
  • [UserExperienceAnalyticsRemoteConnectionId <String>]: The unique identifier of userExperienceAnalyticsRemoteConnection
  • [UserExperienceAnalyticsResourcePerformanceId <String>]: The unique identifier of userExperienceAnalyticsResourcePerformance
  • [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
  • [WindowsQualityUpdateProfileAssignmentId <String>]: The unique identifier of windowsQualityUpdateProfileAssignment
  • [WindowsQualityUpdateProfileId <String>]: The unique identifier of windowsQualityUpdateProfile

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