Share via

New-MgBetaDeviceManagementUserExperienceAnalyticBatteryHealthDevicePerformance

  • Reference
Module:
Microsoft.Graph.Beta.DeviceManagement

Create new navigation property to userExperienceAnalyticsBatteryHealthDevicePerformance for deviceManagement

Syntax

New-MgBetaDeviceManagementUserExperienceAnalyticBatteryHealthDevicePerformance
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-BatteryAgeInDays <Int32>]
   [-DeviceBatteriesDetails <IMicrosoftGraphUserExperienceAnalyticsDeviceBatteryDetail[]>]
   [-DeviceBatteryCount <Int32>]
   [-DeviceBatteryHealthScore <Int32>]
   [-DeviceBatteryTags <String[]>]
   [-DeviceId <String>]
   [-DeviceManufacturerName <String>]
   [-DeviceModelName <String>]
   [-DeviceName <String>]
   [-EstimatedRuntimeInMinutes <Int32>]
   [-FullBatteryDrainCount <Int32>]
   [-HealthStatus <UserExperienceAnalyticsHealthState>]
   [-Id <String>]
   [-Manufacturer <String>]
   [-MaxCapacityPercentage <Int32>]
   [-Model <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaDeviceManagementUserExperienceAnalyticBatteryHealthDevicePerformance
   -BodyParameter <IMicrosoftGraphUserExperienceAnalyticsBatteryHealthDevicePerformance>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to userExperienceAnalyticsBatteryHealthDevicePerformance for deviceManagement

Parameters

-AdditionalProperties

Additional Parameters

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

-BatteryAgeInDays

Estimated battery age. Unit in days. Valid values 0 to 2147483647

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BodyParameter

The user experience analytics battery health device performance entity contains device level battery information. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-DeviceBatteriesDetails

Properties (maxCapacity and cycleCount) related to all batteries of the device. To construct, see NOTES section for DEVICEBATTERIESDETAILS properties and create a hash table.

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

-DeviceBatteryCount

Number of batteries in a user device. Valid values 0 to 2147483647

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceBatteryHealthScore

A weighted average of a device's maximum capacity score and runtime estimate score. Values range from 0-100. Valid values 0 to 2147483647

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceBatteryTags

Tags for computed information on how battery on the device is behaving. E.g. newbattery, batterycapacityred, designcapacityzero, etc.

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

-DeviceId

The unique identifier of the device, Intune DeviceID.

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

-DeviceManufacturerName

The manufacturer name of the device.

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

-DeviceModelName

The model name of the device.

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

-DeviceName

Device friendly name.

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

-EstimatedRuntimeInMinutes

The estimated runtime of the device when the battery is fully charged. Unit in minutes. Valid values 0 to 2147483647

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullBatteryDrainCount

Number of times the battery has been discharged an amount that equals 100% of its capacity, but not necessarily by discharging it from 100% to 0%. Valid values 0 to 2147483647

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

-HealthStatus

userExperienceAnalyticsHealthState

Type:UserExperienceAnalyticsHealthState
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-Manufacturer

The manufacturer name of the device. Deprecated in favor of DeviceManufacturerName.

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

-MaxCapacityPercentage

Ratio of current capacity and design capacity of the battery with the lowest capacity. Unit in percentage and values range from 0-100. Valid values 0 to 2147483647

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Model

The model name of the device. Deprecated in favor of DeviceModelName.

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

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

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphUserExperienceAnalyticsBatteryHealthDevicePerformance

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 <IMicrosoftGraphUserExperienceAnalyticsBatteryHealthDevicePerformance>: The user experience analytics battery health device performance entity contains device level battery information.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [BatteryAgeInDays <Int32?>]: Estimated battery age. Unit in days. Valid values 0 to 2147483647
  • [DeviceBatteriesDetails <IMicrosoftGraphUserExperienceAnalyticsDeviceBatteryDetail- []>]: Properties (maxCapacity and cycleCount) related to all batteries of the device.
    • [BatteryId <String>]: Uniquely identifies the batteries in a single device.
    • [FullBatteryDrainCount <Int32?>]: Number of times the battery has been discharged an amount that equals 100% of its capacity, but not necessarily by discharging it from 100% to 0%. Valid values 0 to 2147483647
    • [MaxCapacityPercentage <Int32?>]: Ratio of current capacity and design capacity of the battery. Unit in percentage and values range from 0-100. Valid values 0 to 2147483647
  • [DeviceBatteryCount <Int32?>]: Number of batteries in a user device. Valid values 0 to 2147483647
  • [DeviceBatteryHealthScore <Int32?>]: A weighted average of a device's maximum capacity score and runtime estimate score. Values range from 0-100. Valid values 0 to 2147483647
  • [DeviceBatteryTags <String- []>]: Tags for computed information on how battery on the device is behaving. E.g. newbattery, batterycapacityred, designcapacityzero, etc.
  • [DeviceId <String>]: The unique identifier of the device, Intune DeviceID.
  • [DeviceManufacturerName <String>]: The manufacturer name of the device.
  • [DeviceModelName <String>]: The model name of the device.
  • [DeviceName <String>]: Device friendly name.
  • [EstimatedRuntimeInMinutes <Int32?>]: The estimated runtime of the device when the battery is fully charged. Unit in minutes. Valid values 0 to 2147483647
  • [FullBatteryDrainCount <Int32?>]: Number of times the battery has been discharged an amount that equals 100% of its capacity, but not necessarily by discharging it from 100% to 0%. Valid values 0 to 2147483647
  • [HealthStatus <UserExperienceAnalyticsHealthState?>]: userExperienceAnalyticsHealthState
  • [Manufacturer <String>]: The manufacturer name of the device. Deprecated in favor of DeviceManufacturerName.
  • [MaxCapacityPercentage <Int32?>]: Ratio of current capacity and design capacity of the battery with the lowest capacity. Unit in percentage and values range from 0-100. Valid values 0 to 2147483647
  • [Model <String>]: The model name of the device. Deprecated in favor of DeviceModelName.

DEVICEBATTERIESDETAILS <IMicrosoftGraphUserExperienceAnalyticsDeviceBatteryDetail- []>: Properties (maxCapacity and cycleCount) related to all batteries of the device.

  • [BatteryId <String>]: Uniquely identifies the batteries in a single device.
  • [FullBatteryDrainCount <Int32?>]: Number of times the battery has been discharged an amount that equals 100% of its capacity, but not necessarily by discharging it from 100% to 0%. Valid values 0 to 2147483647
  • [MaxCapacityPercentage <Int32?>]: Ratio of current capacity and design capacity of the battery. Unit in percentage and values range from 0-100. Valid values 0 to 2147483647