Share via

New-MgDeviceManagementDeviceConfiguration

  • Reference
Module:
Microsoft.Graph.DeviceManagement

Create a new windows10TeamGeneralConfiguration object.

Note

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

Syntax

New-MgDeviceManagementDeviceConfiguration
   [-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>]
New-MgDeviceManagementDeviceConfiguration
   -BodyParameter <IMicrosoftGraphDeviceConfiguration>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a new windows10TeamGeneralConfiguration object.

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.DeviceManagement

$params = @{
	"@odata.type" = "#microsoft.graph.windows10EnterpriseModernAppManagementConfiguration"
	description = "Description value"
	displayName = "Display Name value"
	version = 7
	uninstallBuiltInApps = $true
}

New-MgDeviceManagementDeviceConfiguration -BodyParameter $params

This example shows how to use the New-MgDeviceManagementDeviceConfiguration Cmdlet.

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

-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

-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

{{ 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

-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.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

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