Share via

Update-MgBetaDeviceAppManagementVppToken

  • Reference
Module:
Microsoft.Graph.Beta.Devices.CorporateManagement

Update the navigation property vppTokens in deviceAppManagement

Note

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

Syntax

Update-MgBetaDeviceAppManagementVppToken
      -VppTokenId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-AppleId <String>]
      [-AutomaticallyUpdateApps]
      [-ClaimTokenManagementFromExternalMdm]
      [-CountryOrRegion <String>]
      [-DataSharingConsentGranted]
      [-DisplayName <String>]
      [-ExpirationDateTime <DateTime>]
      [-Id <String>]
      [-LastModifiedDateTime <DateTime>]
      [-LastSyncDateTime <DateTime>]
      [-LastSyncStatus <VppTokenSyncStatus>]
      [-LocationName <String>]
      [-OrganizationName <String>]
      [-RoleScopeTagIds <String[]>]
      [-State <VppTokenState>]
      [-Token <String>]
      [-TokenActionResults <IMicrosoftGraphVppTokenActionResult[]>]
      [-VppTokenAccountType <VppTokenAccountType>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceAppManagementVppToken
      -VppTokenId <String>
      -BodyParameter <IMicrosoftGraphVppToken>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceAppManagementVppToken
      -InputObject <IDevicesCorporateManagementIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-AppleId <String>]
      [-AutomaticallyUpdateApps]
      [-ClaimTokenManagementFromExternalMdm]
      [-CountryOrRegion <String>]
      [-DataSharingConsentGranted]
      [-DisplayName <String>]
      [-ExpirationDateTime <DateTime>]
      [-Id <String>]
      [-LastModifiedDateTime <DateTime>]
      [-LastSyncDateTime <DateTime>]
      [-LastSyncStatus <VppTokenSyncStatus>]
      [-LocationName <String>]
      [-OrganizationName <String>]
      [-RoleScopeTagIds <String[]>]
      [-State <VppTokenState>]
      [-Token <String>]
      [-TokenActionResults <IMicrosoftGraphVppTokenActionResult[]>]
      [-VppTokenAccountType <VppTokenAccountType>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-MgBetaDeviceAppManagementVppToken
      -InputObject <IDevicesCorporateManagementIdentity>
      -BodyParameter <IMicrosoftGraphVppToken>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the navigation property vppTokens in deviceAppManagement

Parameters

-AdditionalProperties

Additional Parameters

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

-AppleId

The apple Id associated with the given Apple Volume Purchase Program Token.

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

-AutomaticallyUpdateApps

Whether or not apps for the VPP token will be automatically updated.

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

-BodyParameter

You purchase multiple licenses for iOS apps through the Apple Volume Purchase Program for Business or Education. This involves setting up an Apple VPP account from the Apple website and uploading the Apple VPP Business or Education token to Intune. You can then synchronize your volume purchase information with Intune and track your volume-purchased app use. You can upload multiple Apple VPP Business or Education tokens. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-ClaimTokenManagementFromExternalMdm

Admin consent to allow claiming token management from external MDM.

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

-CountryOrRegion

Whether or not apps for the VPP token will be automatically updated.

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

-DataSharingConsentGranted

Consent granted for data sharing with the Apple Volume Purchase Program.

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

-DisplayName

An admin specified token friendly name.

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

-ExpirationDateTime

The expiration date time of the Apple Volume Purchase Program Token.

Type:DateTime
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:IDevicesCorporateManagementIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LastModifiedDateTime

Last modification date time associated with the Apple Volume Purchase Program Token.

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

-LastSyncDateTime

The last time when an application sync was done with the Apple volume purchase program service using the the Apple Volume Purchase Program Token.

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

-LastSyncStatus

Possible sync statuses associated with an Apple Volume Purchase Program token.

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

-LocationName

Token location returned from Apple VPP.

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

-OrganizationName

The organization associated with the Apple Volume Purchase Program Token

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

-RoleScopeTagIds

Role Scope Tags IDs assigned to this entity.

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

-State

Possible states associated with an Apple Volume Purchase Program token.

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

-Token

The Apple Volume Purchase Program Token string downloaded from the Apple Volume Purchase Program.

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

-TokenActionResults

The collection of statuses of the actions performed on the Apple Volume Purchase Program Token. To construct, see NOTES section for TOKENACTIONRESULTS properties and create a hash table.

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

-VppTokenAccountType

Possible types of an Apple Volume Purchase Program token.

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

-VppTokenId

The unique identifier of vppToken

Type:String
Position:Named
Default value:None
Required:True
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.IDevicesCorporateManagementIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphVppToken

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphVppToken

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 <IMicrosoftGraphVppToken>: You purchase multiple licenses for iOS apps through the Apple Volume Purchase Program for Business or Education. This involves setting up an Apple VPP account from the Apple website and uploading the Apple VPP Business or Education token to Intune. You can then synchronize your volume purchase information with Intune and track your volume-purchased app use. You can upload multiple Apple VPP Business or Education tokens.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [AppleId <String>]: The apple Id associated with the given Apple Volume Purchase Program Token.
  • [AutomaticallyUpdateApps <Boolean?>]: Whether or not apps for the VPP token will be automatically updated.
  • [ClaimTokenManagementFromExternalMdm <Boolean?>]: Admin consent to allow claiming token management from external MDM.
  • [CountryOrRegion <String>]: Whether or not apps for the VPP token will be automatically updated.
  • [DataSharingConsentGranted <Boolean?>]: Consent granted for data sharing with the Apple Volume Purchase Program.
  • [DisplayName <String>]: An admin specified token friendly name.
  • [ExpirationDateTime <DateTime?>]: The expiration date time of the Apple Volume Purchase Program Token.
  • [LastModifiedDateTime <DateTime?>]: Last modification date time associated with the Apple Volume Purchase Program Token.
  • [LastSyncDateTime <DateTime?>]: The last time when an application sync was done with the Apple volume purchase program service using the the Apple Volume Purchase Program Token.
  • [LastSyncStatus <VppTokenSyncStatus?>]: Possible sync statuses associated with an Apple Volume Purchase Program token.
  • [LocationName <String>]: Token location returned from Apple VPP.
  • [OrganizationName <String>]: The organization associated with the Apple Volume Purchase Program Token
  • [RoleScopeTagIds <String- []>]: Role Scope Tags IDs assigned to this entity.
  • [State <VppTokenState?>]: Possible states associated with an Apple Volume Purchase Program token.
  • [Token <String>]: The Apple Volume Purchase Program Token string downloaded from the Apple Volume Purchase Program.
  • [TokenActionResults <IMicrosoftGraphVppTokenActionResult- []>]: The collection of statuses of the actions performed on the Apple Volume Purchase Program Token.
    • [ActionName <String>]: Action name
    • [ActionState <String>]: actionState
    • [LastUpdatedDateTime <DateTime?>]: Time the action state was last updated
    • [StartDateTime <DateTime?>]: Time the action was initiated
  • [VppTokenAccountType <VppTokenAccountType?>]: Possible types of an Apple Volume Purchase Program token.

INPUTOBJECT <IDevicesCorporateManagementIdentity>: Identity Parameter

  • [AndroidManagedAppProtectionId <String>]: The unique identifier of androidManagedAppProtection
  • [AppLogCollectionRequestId <String>]: The unique identifier of appLogCollectionRequest
  • [AssignmentFilterEvaluationStatusDetailsId <String>]: The unique identifier of assignmentFilterEvaluationStatusDetails
  • [BundleId <String>]: Usage: bundleId='{bundleId}'
  • [DefaultManagedAppProtectionId <String>]: The unique identifier of defaultManagedAppProtection
  • [DetectedAppId <String>]: The unique identifier of detectedApp
  • [DeviceAppManagementTaskId <String>]: The unique identifier of deviceAppManagementTask
  • [DeviceCompliancePolicyStateId <String>]: The unique identifier of deviceCompliancePolicyState
  • [DeviceConfigurationStateId <String>]: The unique identifier of deviceConfigurationState
  • [DeviceEnrollmentConfigurationId <String>]: The unique identifier of deviceEnrollmentConfiguration
  • [DeviceId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [DeviceInstallStateId <String>]: The unique identifier of deviceInstallState
  • [DeviceLogCollectionResponseId <String>]: The unique identifier of deviceLogCollectionResponse
  • [DeviceManagementConfigurationSettingDefinitionId <String>]: The unique identifier of deviceManagementConfigurationSettingDefinition
  • [DeviceManagementConfigurationSettingId <String>]: The unique identifier of deviceManagementConfigurationSetting
  • [DeviceManagementTroubleshootingEventId <String>]: The unique identifier of deviceManagementTroubleshootingEvent
  • [EnrollmentConfigurationAssignmentId <String>]: The unique identifier of enrollmentConfigurationAssignment
  • [EnterpriseCodeSigningCertificateId <String>]: The unique identifier of enterpriseCodeSigningCertificate
  • [Id <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [IosLobAppProvisioningConfigurationAssignmentId <String>]: The unique identifier of iosLobAppProvisioningConfigurationAssignment
  • [IosLobAppProvisioningConfigurationId <String>]: The unique identifier of iosLobAppProvisioningConfiguration
  • [IosManagedAppProtectionId <String>]: The unique identifier of iosManagedAppProtection
  • [IosVppAppAssignedLicenseId <String>]: The unique identifier of iosVppAppAssignedLicense
  • [ManagedAppLogCollectionRequestId <String>]: The unique identifier of managedAppLogCollectionRequest
  • [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
  • [ManagedDeviceMobileAppConfigurationStateId <String>]: The unique identifier of managedDeviceMobileAppConfigurationState
  • [ManagedDeviceMobileAppConfigurationUserStatusId <String>]: The unique identifier of managedDeviceMobileAppConfigurationUserStatus
  • [ManagedEBookAssignmentId <String>]: The unique identifier of managedEBookAssignment
  • [ManagedEBookCategoryId <String>]: The unique identifier of managedEBookCategory
  • [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
  • [MobileAppCatalogPackageId <String>]: The unique identifier of mobileAppCatalogPackage
  • [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
  • [MobileAppIntentAndStateId <String>]: The unique identifier of mobileAppIntentAndState
  • [MobileAppProvisioningConfigGroupAssignmentId <String>]: The unique identifier of mobileAppProvisioningConfigGroupAssignment
  • [MobileAppRelationshipId <String>]: The unique identifier of mobileAppRelationship
  • [MobileAppTroubleshootingEventId <String>]: The unique identifier of mobileAppTroubleshootingEvent
  • [MobileContainedAppId <String>]: The unique identifier of mobileContainedApp
  • [PolicyId <String>]: Property in multi-part unique identifier of deviceHealthScriptPolicyState
  • [PolicySetAssignmentId <String>]: The unique identifier of policySetAssignment
  • [PolicySetId <String>]: The unique identifier of policySet
  • [PolicySetItemId <String>]: The unique identifier of policySetItem
  • [SecurityBaselineSettingStateId <String>]: The unique identifier of securityBaselineSettingState
  • [SecurityBaselineStateId <String>]: The unique identifier of securityBaselineState
  • [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
  • [WindowsDefenderApplicationControlSupplementalPolicyAssignmentId <String>]: The unique identifier of windowsDefenderApplicationControlSupplementalPolicyAssignment
  • [WindowsDefenderApplicationControlSupplementalPolicyDeploymentStatusId <String>]: The unique identifier of windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus
  • [WindowsDefenderApplicationControlSupplementalPolicyId <String>]: The unique identifier of windowsDefenderApplicationControlSupplementalPolicy
  • [WindowsDeviceMalwareStateId <String>]: The unique identifier of windowsDeviceMalwareState
  • [WindowsInformationProtectionAppLockerFileId <String>]: The unique identifier of windowsInformationProtectionAppLockerFile
  • [WindowsInformationProtectionDeviceRegistrationId <String>]: The unique identifier of windowsInformationProtectionDeviceRegistration
  • [WindowsInformationProtectionPolicyId <String>]: The unique identifier of windowsInformationProtectionPolicy
  • [WindowsInformationProtectionWipeActionId <String>]: The unique identifier of windowsInformationProtectionWipeAction
  • [WindowsManagedAppProtectionId <String>]: The unique identifier of windowsManagedAppProtection

TOKENACTIONRESULTS <IMicrosoftGraphVppTokenActionResult- []>: The collection of statuses of the actions performed on the Apple Volume Purchase Program Token.

  • [ActionName <String>]: Action name
  • [ActionState <String>]: actionState
  • [LastUpdatedDateTime <DateTime?>]: Time the action state was last updated
  • [StartDateTime <DateTime?>]: Time the action was initiated

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.devices.corporatemanagement/update-mgbetadeviceappmanagementvpptoken