Update-MgDeviceAppManagementManagedEBookUserStateSummary

Module:

Microsoft.Graph.Devices.CorporateManagement Module

Update the properties of a userInstallStateSummary object.

Note

To view the beta release of this cmdlet, view Update-MgBetaDeviceAppManagementManagedEBookUserStateSummary

Syntax

UpdateExpanded (Default)

Update-MgDeviceAppManagementManagedEBookUserStateSummary
    -ManagedEBookId <String>
    -UserInstallStateSummaryId <String>
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-DeviceStates <IMicrosoftGraphDeviceInstallState[]>]
    [-FailedDeviceCount <Int32>]
    [-Id <String>]
    [-InstalledDeviceCount <Int32>]
    [-NotInstalledDeviceCount <Int32>]
    [-UserName <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update

Update-MgDeviceAppManagementManagedEBookUserStateSummary
    -ManagedEBookId <String>
    -UserInstallStateSummaryId <String>
    -BodyParameter <IMicrosoftGraphUserInstallStateSummary>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-MgDeviceAppManagementManagedEBookUserStateSummary
    -InputObject <IDevicesCorporateManagementIdentity>
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-DeviceStates <IMicrosoftGraphDeviceInstallState[]>]
    [-FailedDeviceCount <Int32>]
    [-Id <String>]
    [-InstalledDeviceCount <Int32>]
    [-NotInstalledDeviceCount <Int32>]
    [-UserName <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentity

Update-MgDeviceAppManagementManagedEBookUserStateSummary
    -InputObject <IDevicesCorporateManagementIdentity>
    -BodyParameter <IMicrosoftGraphUserInstallStateSummary>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Update the properties of a userInstallStateSummary object.

Permissions

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	DeviceManagementApps.ReadWrite.All,
Delegated (personal Microsoft account)	Not supported
Application	DeviceManagementApps.ReadWrite.All,

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Devices.CorporateManagement

$params = @{
	"@odata.type" = "#microsoft.graph.userInstallStateSummary"
	userName = "User Name value"
	installedDeviceCount = 4
	failedDeviceCount = 1
	notInstalledDeviceCount = 7
}

Update-MgDeviceAppManagementManagedEBookUserStateSummary -ManagedEBookId $managedEBookId -UserInstallStateSummaryId $userInstallStateSummaryId -BodyParameter $params

This example shows how to use the Update-MgDeviceAppManagementManagedEBookUserStateSummary Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

Parameter properties

Type:	Hashtable
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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

-BodyParameter

Contains properties for the installation state summary for a user. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphUserInstallStateSummary
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

Update

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

UpdateViaIdentity

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:	SwitchParameter
Default value:	None
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

-DeviceStates

The install state of the eBook. To construct, see NOTES section for DEVICESTATES properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphDeviceInstallState[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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

-FailedDeviceCount

Failed Device Count.

Parameter properties

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

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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:	IDictionary
Default value:	None
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

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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:	IDevicesCorporateManagementIdentity
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateViaIdentityExpanded

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

UpdateViaIdentity

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

-InstalledDeviceCount

Installed Device Count.

Parameter properties

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

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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

-ManagedEBookId

The unique identifier of managedEBook

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateExpanded

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

Update

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

-NotInstalledDeviceCount

Not installed device count.

Parameter properties

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

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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:	String
Default value:	None
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

-UserInstallStateSummaryId

The unique identifier of userInstallStateSummary

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateExpanded

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

Update

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

-UserName

User name.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateExpanded

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

UpdateViaIdentityExpanded

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

-WhatIf

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

Parameter properties

Type:	SwitchParameter
Default value:	None
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

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphUserInstallStateSummary

System.Collections.IDictionary

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphUserInstallStateSummary

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 <IMicrosoftGraphUserInstallStateSummary>: Contains properties for the installation state summary for a user.

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [DeviceStates <IMicrosoftGraphDeviceInstallState- []>]: The install state of the eBook.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [DeviceId <String>]: Device Id.
  • [DeviceName <String>]: Device name.
  • [ErrorCode <String>]: The error code for install failures.
  • [InstallState <InstallState?>]: Possible values for install state.
  • [LastSyncDateTime <DateTime?>]: Last sync date and time.
  • [OSDescription <String>]: OS Description.
  • [OSVersion <String>]: OS Version.
  • [UserName <String>]: Device User Name.
• [FailedDeviceCount <Int32?>]: Failed Device Count.
• [InstalledDeviceCount <Int32?>]: Installed Device Count.
• [NotInstalledDeviceCount <Int32?>]: Not installed device count.
• [UserName <String>]: User name.

DEVICESTATES <IMicrosoftGraphDeviceInstallState- []>: The install state of the eBook.

• [Id <String>]: The unique identifier for an entity. Read-only.
• [DeviceId <String>]: Device Id.
• [DeviceName <String>]: Device name.
• [ErrorCode <String>]: The error code for install failures.
• [InstallState <InstallState?>]: Possible values for install state.
• [LastSyncDateTime <DateTime?>]: Last sync date and time.
• [OSDescription <String>]: OS Description.
• [OSVersion <String>]: OS Version.
• [UserName <String>]: Device User Name.

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
• [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

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.devices.corporatemanagement/update-mgdeviceappmanagementmanagedebookuserstatesummary
• https://learn.microsoft.com/graph/api/intune-books-userinstallstatesummary-update?view=graph-rest-1.0