New-MgUserManagedDeviceConfigurationState

Module:

Microsoft.Graph.Devices.CorporateManagement Module

Create new navigation property to deviceConfigurationStates for users

Note

To view the beta release of this cmdlet, view New-MgBetaUserManagedDeviceConfigurationState

Syntax

CreateExpanded (Default)

New-MgUserManagedDeviceConfigurationState
    -ManagedDeviceId <string>
    -UserId <string>
    [-ResponseHeadersVariable <string>]
    [-AdditionalProperties <hashtable>]
    [-DisplayName <string>]
    [-Id <string>]
    [-PlatformType <PolicyPlatformType>]
    [-SettingCount <int>]
    [-SettingStates <IMicrosoftGraphDeviceConfigurationSettingState[]>]
    [-State <string>]
    [-Version <int>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgUserManagedDeviceConfigurationState
    -ManagedDeviceId <string>
    -UserId <string>
    -BodyParameter <IMicrosoftGraphDeviceConfigurationState>
    [-ResponseHeadersVariable <string>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpanded

New-MgUserManagedDeviceConfigurationState
    -InputObject <IDevicesCorporateManagementIdentity>
    [-ResponseHeadersVariable <string>]
    [-AdditionalProperties <hashtable>]
    [-DisplayName <string>]
    [-Id <string>]
    [-PlatformType <PolicyPlatformType>]
    [-SettingCount <int>]
    [-SettingStates <IMicrosoftGraphDeviceConfigurationSettingState[]>]
    [-State <string>]
    [-Version <int>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentity

New-MgUserManagedDeviceConfigurationState
    -InputObject <IDevicesCorporateManagementIdentity>
    -BodyParameter <IMicrosoftGraphDeviceConfigurationState>
    [-ResponseHeadersVariable <string>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Parameters

-AdditionalProperties

Additional Parameters

Parameter properties

Type:	System.Collections.Hashtable
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-BodyParameter

Support for this Entity is being deprecated starting May 2026 & will no longer be supported. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

Type:	Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceConfigurationState
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentity

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

Create

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Break

Wait for .NET debugger to attach

Parameter properties

Type:	System.Management.Automation.SwitchParameter
Default value:	False
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:	System.Management.Automation.SwitchParameter
Supports wildcards:	False
DontShow:	False
Aliases:	cf

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DisplayName

The name of the policy for this policyBase

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Headers

Optional headers that will be added to the request.

Parameter properties

Type:	System.Collections.IDictionary
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-HttpPipelineAppend

SendAsync Pipeline Steps to be appended to the front of the pipeline

Parameter properties

Type:	Microsoft.Graph.PowerShell.Runtime.SendAsyncStep[]
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-HttpPipelinePrepend

SendAsync Pipeline Steps to be prepended to the front of the pipeline

Parameter properties

Type:	Microsoft.Graph.PowerShell.Runtime.SendAsyncStep[]
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-InputObject

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

Parameter properties

Type:	Microsoft.Graph.PowerShell.Models.IDevicesCorporateManagementIdentity
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateViaIdentity

Position:	Named
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ManagedDeviceId

The unique identifier of managedDevice

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

Create

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-PlatformType

Supported platform types for policies.

Parameter properties

Type:	Microsoft.Graph.PowerShell.Support.PolicyPlatformType
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Proxy

The URI for the proxy server to use

Parameter properties

Type:	System.Uri
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ProxyCredential

Credentials for a proxy server to use for the remote call

Parameter properties

Type:	System.Management.Automation.PSCredential
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ProxyUseDefaultCredentials

Use the default credentials for the proxy

Parameter properties

Type:	System.Management.Automation.SwitchParameter
Default value:	False
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False
Aliases:	RHV

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-SettingCount

Count of how many setting a policy holds

Parameter properties

Type:	System.Int32
Default value:	0
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-SettingStates

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

Parameter properties

Type:	Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceConfigurationSettingState[]
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-State

complianceStatus

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-UserId

The unique identifier of user

Parameter properties

Type:	System.String
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateExpanded

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

Create

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Version

The version of the policy

Parameter properties

Type:	System.Int32
Default value:	0
Supports wildcards:	False
DontShow:	False

Parameter sets

CreateViaIdentityExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CreateExpanded

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-WhatIf

Runs the command in a mode that only reports what would happen without performing the actions.

Parameter properties

Type:	System.Management.Automation.SwitchParameter
Supports wildcards:	False
DontShow:	False
Aliases:	wi

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.Graph.PowerShell.Models.IDevicesCorporateManagementIdentity

{{ Fill in the Description }}

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceConfigurationState

{{ Fill in the Description }}

System.Collections.IDictionary

{{ Fill in the Description }}

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphDeviceConfigurationState

{{ Fill in the Description }}

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 <IMicrosoftGraphDeviceConfigurationState>: Support for this Entity is being deprecated starting May 2026 & will no longer be supported. [(Any) <Object>]: This indicates any property can be added to this object. [Id <String>]: The unique identifier for an entity. Read-only. [DisplayName <String>]: The name of the policy for this policyBase [PlatformType <PolicyPlatformType?>]: Supported platform types for policies. [SettingCount <Int32?>]: Count of how many setting a policy holds [SettingStates <IMicrosoftGraphDeviceConfigurationSettingState[]>]: [CurrentValue <String>]: Current value of setting on device [ErrorCode <Int64?>]: Error code for the setting [ErrorDescription <String>]: Error description [InstanceDisplayName <String>]: Name of setting instance that is being reported. [Setting <String>]: The setting that is being reported [SettingName <String>]: Localized/user friendly setting name that is being reported [Sources <IMicrosoftGraphSettingSource[]>]: Contributing policies [DisplayName <String>]: [Id <String>]: [SourceType <String>]: settingSourceType [State <String>]: complianceStatus [UserEmail <String>]: UserEmail [UserId <String>]: UserId [UserName <String>]: UserName [UserPrincipalName <String>]: UserPrincipalName. [State <String>]: complianceStatus [Version <Int32?>]: The version of the policy

INPUTOBJECT <IDevicesCorporateManagementIdentity>: Identity Parameter [AndroidManagedAppProtectionId <String>]: The unique identifier of androidManagedAppProtection [DefaultManagedAppProtectionId <String>]: The unique identifier of defaultManagedAppProtection [DeviceCompliancePolicyStateId <String>]: The unique identifier of deviceCompliancePolicyState [DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState [DeviceInstallStateId <String>]: The unique identifier of deviceInstallState [DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse [DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent [IosManagedAppProtectionId <String>]: The unique identifier of iosManagedAppProtection [ManagedAppOperationId <String>]: The unique identifier of managedAppOperation [ManagedAppPolicyId <String>]: The unique identifier of managedAppPolicy [ManagedAppRegistrationId <String>]: The unique identifier of managedAppRegistration [ManagedAppStatusId <String>]: The unique identifier of managedAppStatus [ManagedDeviceId <String>]: The unique identifier of managedDevice [ManagedDeviceMobileAppConfigurationAssignmentId <String>]: The unique identifier of managedDeviceMobileAppConfigurationAssignment [ManagedDeviceMobileAppConfigurationDeviceStatusId <String>]: The unique identifier of managedDeviceMobileAppConfigurationDeviceStatus [ManagedDeviceMobileAppConfigurationId <String>]: The unique identifier of managedDeviceMobileAppConfiguration [ManagedDeviceMobileAppConfigurationUserStatusId <String>]: The unique identifier of managedDeviceMobileAppConfigurationUserStatus [ManagedEBookAssignmentId <String>]: The unique identifier of managedEBookAssignment [ManagedEBookId <String>]: The unique identifier of managedEBook [ManagedMobileAppId <String>]: The unique identifier of managedMobileApp [MdmWindowsInformationProtectionPolicyId <String>]: The unique identifier of mdmWindowsInformationProtectionPolicy [MobileAppAssignmentId <String>]: The unique identifier of mobileAppAssignment [MobileAppCategoryId <String>]: The unique identifier of mobileAppCategory [MobileAppContentFileId <String>]: The unique identifier of mobileAppContentFile [MobileAppContentId <String>]: The unique identifier of mobileAppContent [MobileAppId <String>]: The unique identifier of mobileApp [MobileAppRelationshipId <String>]: The unique identifier of mobileAppRelationship [MobileContainedAppId <String>]: The unique identifier of mobileContainedApp [TargetedManagedAppConfigurationId <String>]: The unique identifier of targetedManagedAppConfiguration [TargetedManagedAppPolicyAssignmentId <String>]: The unique identifier of targetedManagedAppPolicyAssignment [UserId <String>]: The unique identifier of user [UserInstallStateSummaryId <String>]: The unique identifier of userInstallStateSummary [VppTokenId <String>]: The unique identifier of vppToken [WindowsDeviceMalwareStateId <String>]: The unique identifier of windowsDeviceMalwareState [WindowsInformationProtectionAppLockerFileId <String>]: The unique identifier of windowsInformationProtectionAppLockerFile [WindowsInformationProtectionPolicyId <String>]: The unique identifier of windowsInformationProtectionPolicy

SETTINGSTATES <IMicrosoftGraphDeviceConfigurationSettingState[]>: . [CurrentValue <String>]: Current value of setting on device [ErrorCode <Int64?>]: Error code for the setting [ErrorDescription <String>]: Error description [InstanceDisplayName <String>]: Name of setting instance that is being reported. [Setting <String>]: The setting that is being reported [SettingName <String>]: Localized/user friendly setting name that is being reported [Sources <IMicrosoftGraphSettingSource[]>]: Contributing policies [DisplayName <String>]: [Id <String>]: [SourceType <String>]: settingSourceType [State <String>]: complianceStatus [UserEmail <String>]: UserEmail [UserId <String>]: UserId [UserName <String>]: UserName [UserPrincipalName <String>]: UserPrincipalName.

Related Links

• New-MgUserManagedDeviceConfigurationState