Namespace: microsoft.graph
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Update the properties of a windowsMobileMSI object.
This API is available in the following national cloud deployments.
Global service |
US Government L4 |
US Government L5 (DOD) |
China operated by 21Vianet |
✅ |
✅ |
✅ |
✅ |
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see 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 |
HTTP Request
PATCH /deviceAppManagement/mobileApps/{mobileAppId}
Request body
In the request body, supply a JSON representation for the windowsMobileMSI object.
The following table shows the properties that are required when you create the windowsMobileMSI.
Property |
Type |
Description |
id |
String |
Key of the entity. Inherited from mobileApp |
displayName |
String |
The admin provided or imported title of the app. Inherited from mobileApp |
description |
String |
The description of the app. Inherited from mobileApp |
publisher |
String |
The publisher of the app. Inherited from mobileApp |
largeIcon |
mimeContent |
The large icon, to be displayed in the app details and used for upload of the icon. Inherited from mobileApp |
createdDateTime |
DateTimeOffset |
The date and time the app was created. Inherited from mobileApp |
lastModifiedDateTime |
DateTimeOffset |
The date and time the app was last modified. Inherited from mobileApp |
isFeatured |
Boolean |
The value indicating whether the app is marked as featured by the admin. Inherited from mobileApp |
privacyInformationUrl |
String |
The privacy statement Url. Inherited from mobileApp |
informationUrl |
String |
The more information Url. Inherited from mobileApp |
owner |
String |
The owner of the app. Inherited from mobileApp |
developer |
String |
The developer of the app. Inherited from mobileApp |
notes |
String |
Notes for the app. Inherited from mobileApp |
publishingState |
mobileAppPublishingState |
The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from mobileApp. Possible values are: notPublished , processing , published . |
committedContentVersion |
String |
The internal committed content version. Inherited from mobileLobApp |
fileName |
String |
The name of the main Lob application file. Inherited from mobileLobApp |
size |
Int64 |
The total size, including all uploaded files. Inherited from mobileLobApp |
commandLine |
String |
The command line. |
productCode |
String |
The product code. |
productVersion |
String |
The product version of Windows Mobile MSI Line of Business (LoB) app. |
ignoreVersionDetection |
Boolean |
A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for Windows Mobile MSI Line of Business (LoB) apps that use a self update feature. |
Response
If successful, this method returns a 200 OK
response code and an updated windowsMobileMSI object in the response body.
Example
Request
Here is an example of the request.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 855
{
"@odata.type": "#microsoft.graph.windowsMobileMSI",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"publishingState": "processing",
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"commandLine": "Command Line value",
"productCode": "Product Code value",
"productVersion": "Product Version value",
"ignoreVersionDetection": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new WindowsMobileMSI
{
OdataType = "#microsoft.graph.windowsMobileMSI",
DisplayName = "Display Name value",
Description = "Description value",
Publisher = "Publisher value",
LargeIcon = new MimeContent
{
OdataType = "microsoft.graph.mimeContent",
Type = "Type value",
Value = Convert.FromBase64String("dmFsdWU="),
},
IsFeatured = true,
PrivacyInformationUrl = "https://example.com/privacyInformationUrl/",
InformationUrl = "https://example.com/informationUrl/",
Owner = "Owner value",
Developer = "Developer value",
Notes = "Notes value",
PublishingState = MobileAppPublishingState.Processing,
CommittedContentVersion = "Committed Content Version value",
FileName = "File Name value",
Size = 4L,
CommandLine = "Command Line value",
ProductCode = "Product Code value",
ProductVersion = "Product Version value",
IgnoreVersionDetection = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.MobileApps["{mobileApp-id}"].PatchAsync(requestBody);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
mgc device-app-management mobile-apps patch --mobile-app-id {mobileApp-id} --body '{\
"@odata.type": "#microsoft.graph.windowsMobileMSI",\
"displayName": "Display Name value",\
"description": "Description value",\
"publisher": "Publisher value",\
"largeIcon": {\
"@odata.type": "microsoft.graph.mimeContent",\
"type": "Type value",\
"value": "dmFsdWU="\
},\
"isFeatured": true,\
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",\
"informationUrl": "https://example.com/informationUrl/",\
"owner": "Owner value",\
"developer": "Developer value",\
"notes": "Notes value",\
"publishingState": "processing",\
"committedContentVersion": "Committed Content Version value",\
"fileName": "File Name value",\
"size": 4,\
"commandLine": "Command Line value",\
"productCode": "Product Code value",\
"productVersion": "Product Version value",\
"ignoreVersionDetection": true\
}\
'
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewMobileApp()
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName)
description := "Description value"
requestBody.SetDescription(&description)
publisher := "Publisher value"
requestBody.SetPublisher(&publisher)
largeIcon := graphmodels.NewMimeContent()
type := "Type value"
largeIcon.SetType(&type)
value := []byte("dmFsdWU=")
largeIcon.SetValue(&value)
requestBody.SetLargeIcon(largeIcon)
isFeatured := true
requestBody.SetIsFeatured(&isFeatured)
privacyInformationUrl := "https://example.com/privacyInformationUrl/"
requestBody.SetPrivacyInformationUrl(&privacyInformationUrl)
informationUrl := "https://example.com/informationUrl/"
requestBody.SetInformationUrl(&informationUrl)
owner := "Owner value"
requestBody.SetOwner(&owner)
developer := "Developer value"
requestBody.SetDeveloper(&developer)
notes := "Notes value"
requestBody.SetNotes(¬es)
publishingState := graphmodels.PROCESSING_MOBILEAPPPUBLISHINGSTATE
requestBody.SetPublishingState(&publishingState)
committedContentVersion := "Committed Content Version value"
requestBody.SetCommittedContentVersion(&committedContentVersion)
fileName := "File Name value"
requestBody.SetFileName(&fileName)
size := int64(4)
requestBody.SetSize(&size)
commandLine := "Command Line value"
requestBody.SetCommandLine(&commandLine)
productCode := "Product Code value"
requestBody.SetProductCode(&productCode)
productVersion := "Product Version value"
requestBody.SetProductVersion(&productVersion)
ignoreVersionDetection := true
requestBody.SetIgnoreVersionDetection(&ignoreVersionDetection)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
mobileApps, err := graphClient.DeviceAppManagement().MobileApps().ByMobileAppId("mobileApp-id").Patch(context.Background(), requestBody, nil)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WindowsMobileMSI mobileApp = new WindowsMobileMSI();
mobileApp.setOdataType("#microsoft.graph.windowsMobileMSI");
mobileApp.setDisplayName("Display Name value");
mobileApp.setDescription("Description value");
mobileApp.setPublisher("Publisher value");
MimeContent largeIcon = new MimeContent();
largeIcon.setOdataType("microsoft.graph.mimeContent");
largeIcon.setType("Type value");
byte[] value = Base64.getDecoder().decode("dmFsdWU=");
largeIcon.setValue(value);
mobileApp.setLargeIcon(largeIcon);
mobileApp.setIsFeatured(true);
mobileApp.setPrivacyInformationUrl("https://example.com/privacyInformationUrl/");
mobileApp.setInformationUrl("https://example.com/informationUrl/");
mobileApp.setOwner("Owner value");
mobileApp.setDeveloper("Developer value");
mobileApp.setNotes("Notes value");
mobileApp.setPublishingState(MobileAppPublishingState.Processing);
mobileApp.setCommittedContentVersion("Committed Content Version value");
mobileApp.setFileName("File Name value");
mobileApp.setSize(4L);
mobileApp.setCommandLine("Command Line value");
mobileApp.setProductCode("Product Code value");
mobileApp.setProductVersion("Product Version value");
mobileApp.setIgnoreVersionDetection(true);
MobileApp result = graphClient.deviceAppManagement().mobileApps().byMobileAppId("{mobileApp-id}").patch(mobileApp);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
const options = {
authProvider,
};
const client = Client.init(options);
const mobileApp = {
'@odata.type': '#microsoft.graph.windowsMobileMSI',
displayName: 'Display Name value',
description: 'Description value',
publisher: 'Publisher value',
largeIcon: {
'@odata.type': 'microsoft.graph.mimeContent',
type: 'Type value',
value: 'dmFsdWU='
},
isFeatured: true,
privacyInformationUrl: 'https://example.com/privacyInformationUrl/',
informationUrl: 'https://example.com/informationUrl/',
owner: 'Owner value',
developer: 'Developer value',
notes: 'Notes value',
publishingState: 'processing',
committedContentVersion: 'Committed Content Version value',
fileName: 'File Name value',
size: 4,
commandLine: 'Command Line value',
productCode: 'Product Code value',
productVersion: 'Product Version value',
ignoreVersionDetection: true
};
await client.api('/deviceAppManagement/mobileApps/{mobileAppId}')
.update(mobileApp);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsMobileMSI;
use Microsoft\Graph\Generated\Models\MimeContent;
use Microsoft\Graph\Generated\Models\MobileAppPublishingState;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new WindowsMobileMSI();
$requestBody->setOdataType('#microsoft.graph.windowsMobileMSI');
$requestBody->setDisplayName('Display Name value');
$requestBody->setDescription('Description value');
$requestBody->setPublisher('Publisher value');
$largeIcon = new MimeContent();
$largeIcon->setOdataType('microsoft.graph.mimeContent');
$largeIcon->setType('Type value');
$largeIcon->setValue(\GuzzleHttp\Psr7\Utils::streamFor(base64_decode('dmFsdWU=')));
$requestBody->setLargeIcon($largeIcon);
$requestBody->setIsFeatured(true);
$requestBody->setPrivacyInformationUrl('https://example.com/privacyInformationUrl/');
$requestBody->setInformationUrl('https://example.com/informationUrl/');
$requestBody->setOwner('Owner value');
$requestBody->setDeveloper('Developer value');
$requestBody->setNotes('Notes value');
$requestBody->setPublishingState(new MobileAppPublishingState('processing'));
$requestBody->setCommittedContentVersion('Committed Content Version value');
$requestBody->setFileName('File Name value');
$requestBody->setSize(4);
$requestBody->setCommandLine('Command Line value');
$requestBody->setProductCode('Product Code value');
$requestBody->setProductVersion('Product Version value');
$requestBody->setIgnoreVersionDetection(true);
$result = $graphServiceClient->deviceAppManagement()->mobileApps()->byMobileAppId('mobileApp-id')->patch($requestBody)->wait();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Import-Module Microsoft.Graph.Devices.CorporateManagement
$params = @{
"@odata.type" = "#microsoft.graph.windowsMobileMSI"
displayName = "Display Name value"
description = "Description value"
publisher = "Publisher value"
largeIcon = @{
"@odata.type" = "microsoft.graph.mimeContent"
type = "Type value"
value = [System.Text.Encoding]::ASCII.GetBytes("dmFsdWU=")
}
isFeatured = $true
privacyInformationUrl = "https://example.com/privacyInformationUrl/"
informationUrl = "https://example.com/informationUrl/"
owner = "Owner value"
developer = "Developer value"
notes = "Notes value"
publishingState = "processing"
committedContentVersion = "Committed Content Version value"
fileName = "File Name value"
size =
commandLine = "Command Line value"
productCode = "Product Code value"
productVersion = "Product Version value"
ignoreVersionDetection = $true
}
Update-MgDeviceAppManagementMobileApp -MobileAppId $mobileAppId -BodyParameter $params
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.windows_mobile_m_s_i import WindowsMobileMSI
from msgraph.generated.models.mime_content import MimeContent
from msgraph.generated.models.mobile_app_publishing_state import MobileAppPublishingState
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = WindowsMobileMSI(
odata_type = "#microsoft.graph.windowsMobileMSI",
display_name = "Display Name value",
description = "Description value",
publisher = "Publisher value",
large_icon = MimeContent(
odata_type = "microsoft.graph.mimeContent",
type = "Type value",
value = base64.urlsafe_b64decode("dmFsdWU="),
),
is_featured = True,
privacy_information_url = "https://example.com/privacyInformationUrl/",
information_url = "https://example.com/informationUrl/",
owner = "Owner value",
developer = "Developer value",
notes = "Notes value",
publishing_state = MobileAppPublishingState.Processing,
committed_content_version = "Committed Content Version value",
file_name = "File Name value",
size = 4,
command_line = "Command Line value",
product_code = "Product Code value",
product_version = "Product Version value",
ignore_version_detection = True,
)
result = await graph_client.device_app_management.mobile_apps.by_mobile_app_id('mobileApp-id').patch(request_body)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1027
{
"@odata.type": "#microsoft.graph.windowsMobileMSI",
"id": "aa453e5d-3e5d-aa45-5d3e-45aa5d3e45aa",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"publishingState": "processing",
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"commandLine": "Command Line value",
"productCode": "Product Code value",
"productVersion": "Product Version value",
"ignoreVersionDetection": true
}