Actualizar windowsAppX

Espacio de nombres: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto windowsAppX .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementApps.ReadWrite.All

Solicitud HTTP

PATCH /deviceAppManagement/mobileApps/{mobileAppId}

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto windowsAppX .

En la tabla siguiente se muestran las propiedades necesarias al crear windowsAppX.

Propiedad	Tipo	Descripción
id	Cadena	Clave de la entidad. Heredado de mobileApp.
displayName	Cadena	Título de la aplicación importado o proporcionado por el administrador. Heredado de mobileApp.
description	Cadena	Descripción de la aplicación. Heredado de mobileApp.
publicador	Cadena	Publicador de la aplicación. Heredado de mobileApp.
largeIcon	mimeContent	Icono grande que se mostrará en los detalles de la aplicación y se usa para cargar el icono. Heredado de mobileApp.
createdDateTime	DateTimeOffset	Fecha y hora de creación de la aplicación. Heredado de mobileApp.
lastModifiedDateTime	DateTimeOffset	Fecha y hora de la última modificación de la aplicación. Heredado de mobileApp.
isFeatured	Booleano	Valor que indica si el administrador ha marcado la aplicación como destacada. Heredado de mobileApp.
privacyInformationUrl	Cadena	Dirección URL de la declaración de privacidad. Heredado de mobileApp.
informationUrl	Cadena	Dirección URL para obtener más información. Heredado de mobileApp.
owner	Cadena	Propietario de la aplicación. Heredado de mobileApp.
developer	Cadena	Desarrollador de la aplicación. Heredado de mobileApp.
notas	Cadena	Notas de la aplicación. Heredado de mobileApp.
publishingState	mobileAppPublishingState	Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Se hereda de mobileApp. Los valores posibles son: notPublished, processing y published.
committedContentVersion	Cadena	Versión interna del contenido confirmado. Heredado de mobileLobApp.
fileName	Cadena	Nombre del archivo de la aplicación de LOB principal. Heredado de mobileLobApp.
size	Int64	Tamaño total, incluidos todos los archivos cargados. Heredado de mobileLobApp.
applicableArchitectures	windowsArchitecture	Las arquitecturas de Windows en las que se puede ejecutar esta aplicación. Los valores posibles son: , , , , ; neutralel valor predeterminado es none. armx64x86none Los valores posibles son: none, x86, x64, arm y neutral.
identityName	Cadena	Nombre de identidad del paquete de aplicación cargado. Por ejemplo: "Contoso.DemoApp".
identityPublisherHash	Cadena	Hash del publicador de identidades del paquete de aplicación cargado. Este es el hash del publicador del manifiesto. Por ejemplo: "AB82CD0XYZ".
identityResourceIdentifier	Cadena	Identificador de recurso de identidad del paquete de aplicación cargado. Por ejemplo: "TestResourceId".
isBundle	Booleano	Cuando es TRUE, indica que la aplicación es una agrupación. Cuando es FALSE, indica que la aplicación no es una agrupación. De forma predeterminada, la propiedad se establece en FALSE.
minimumSupportedOperatingSystem	windowsMinimumOperatingSystem	Valor del sistema operativo mínimo aplicable. Los valores válidos para una aplicación WindowsAppX incluyen v8_0, v8_1 y v10_0. Si la aplicación es una agrupación, el sistema operativo mínimo admitido debe ser al menos v8_1.
identityVersion	Cadena	La versión de identidad del paquete de aplicación cargado. Por ejemplo: "1.0.0.0".

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto windowsAppX actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

HTTP

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1141

{
  "@odata.type": "#microsoft.graph.windowsAppX",
  "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,
  "applicableArchitectures": "x86",
  "identityName": "Identity Name value",
  "identityPublisherHash": "Identity Publisher Hash value",
  "identityResourceIdentifier": "Identity Resource Identifier value",
  "isBundle": true,
  "minimumSupportedOperatingSystem": {
    "@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
    "v8_0": true,
    "v8_1": true,
    "v10_0": true
  },
  "identityVersion": "Identity Version value"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WindowsAppX
{
	OdataType = "#microsoft.graph.windowsAppX",
	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,
	ApplicableArchitectures = WindowsArchitecture.X86,
	IdentityName = "Identity Name value",
	IdentityPublisherHash = "Identity Publisher Hash value",
	IdentityResourceIdentifier = "Identity Resource Identifier value",
	IsBundle = true,
	MinimumSupportedOperatingSystem = new WindowsMinimumOperatingSystem
	{
		OdataType = "microsoft.graph.windowsMinimumOperatingSystem",
		V80 = true,
		V81 = true,
		V100 = true,
	},
	IdentityVersion = "Identity Version value",
};

// 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);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

CLI

// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc device-app-management mobile-apps patch --mobile-app-id {mobileApp-id} --body '{\
  "@odata.type": "#microsoft.graph.windowsAppX",\
  "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,\
  "applicableArchitectures": "x86",\
  "identityName": "Identity Name value",\
  "identityPublisherHash": "Identity Publisher Hash value",\
  "identityResourceIdentifier": "Identity Resource Identifier value",\
  "isBundle": true,\
  "minimumSupportedOperatingSystem": {\
    "@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",\
    "v8_0": true,\
    "v8_1": true,\
    "v10_0": true\
  },\
  "identityVersion": "Identity Version value"\
}\
'

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Ir

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


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(&notes) 
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) 
applicableArchitectures := graphmodels.X86_WINDOWSARCHITECTURE 
requestBody.SetApplicableArchitectures(&applicableArchitectures) 
identityName := "Identity Name value"
requestBody.SetIdentityName(&identityName) 
identityPublisherHash := "Identity Publisher Hash value"
requestBody.SetIdentityPublisherHash(&identityPublisherHash) 
identityResourceIdentifier := "Identity Resource Identifier value"
requestBody.SetIdentityResourceIdentifier(&identityResourceIdentifier) 
isBundle := true
requestBody.SetIsBundle(&isBundle) 
minimumSupportedOperatingSystem := graphmodels.NewWindowsMinimumOperatingSystem()
v8_0 := true
minimumSupportedOperatingSystem.SetV8_0(&v8_0) 
v8_1 := true
minimumSupportedOperatingSystem.SetV8_1(&v8_1) 
v10_0 := true
minimumSupportedOperatingSystem.SetV10_0(&v10_0) 
requestBody.SetMinimumSupportedOperatingSystem(minimumSupportedOperatingSystem)
identityVersion := "Identity Version value"
requestBody.SetIdentityVersion(&identityVersion) 

mobileApps, err := graphClient.DeviceAppManagement().MobileApps().ByMobileAppId("mobileApp-id").Patch(context.Background(), requestBody, nil)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

WindowsAppX mobileApp = new WindowsAppX();
mobileApp.setOdataType("#microsoft.graph.windowsAppX");
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.setApplicableArchitectures(EnumSet.of(WindowsArchitecture.X86));
mobileApp.setIdentityName("Identity Name value");
mobileApp.setIdentityPublisherHash("Identity Publisher Hash value");
mobileApp.setIdentityResourceIdentifier("Identity Resource Identifier value");
mobileApp.setIsBundle(true);
WindowsMinimumOperatingSystem minimumSupportedOperatingSystem = new WindowsMinimumOperatingSystem();
minimumSupportedOperatingSystem.setOdataType("microsoft.graph.windowsMinimumOperatingSystem");
minimumSupportedOperatingSystem.setV80(true);
minimumSupportedOperatingSystem.setV81(true);
minimumSupportedOperatingSystem.setV100(true);
mobileApp.setMinimumSupportedOperatingSystem(minimumSupportedOperatingSystem);
mobileApp.setIdentityVersion("Identity Version value");
MobileApp result = graphClient.deviceAppManagement().mobileApps().byMobileAppId("{mobileApp-id}").patch(mobileApp);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const mobileApp = {
  '@odata.type': '#microsoft.graph.windowsAppX',
  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,
  applicableArchitectures: 'x86',
  identityName: 'Identity Name value',
  identityPublisherHash: 'Identity Publisher Hash value',
  identityResourceIdentifier: 'Identity Resource Identifier value',
  isBundle: true,
  minimumSupportedOperatingSystem: {
    '@odata.type': 'microsoft.graph.windowsMinimumOperatingSystem',
    v8_0: true,
    v8_1: true,
    v10_0: true
  },
  identityVersion: 'Identity Version value'
};

await client.api('/deviceAppManagement/mobileApps/{mobileAppId}')
	.update(mobileApp);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsAppX;
use Microsoft\Graph\Generated\Models\MimeContent;
use Microsoft\Graph\Generated\Models\WindowsMinimumOperatingSystem;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new WindowsAppX();
$requestBody->setOdataType('#microsoft.graph.windowsAppX');
$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->setApplicableArchitectures(new WindowsArchitecture('x86'));
$requestBody->setIdentityName('Identity Name value');
$requestBody->setIdentityPublisherHash('Identity Publisher Hash value');
$requestBody->setIdentityResourceIdentifier('Identity Resource Identifier value');
$requestBody->setIsBundle(true);
$minimumSupportedOperatingSystem = new WindowsMinimumOperatingSystem();
$minimumSupportedOperatingSystem->setOdataType('microsoft.graph.windowsMinimumOperatingSystem');
$minimumSupportedOperatingSystem->setV80(true);
$minimumSupportedOperatingSystem->setV81(true);
$minimumSupportedOperatingSystem->setV100(true);
$requestBody->setMinimumSupportedOperatingSystem($minimumSupportedOperatingSystem);
$requestBody->setIdentityVersion('Identity Version value');

$result = $graphServiceClient->deviceAppManagement()->mobileApps()->byMobileAppId('mobileApp-id')->patch($requestBody)->wait();

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PowerShell

Import-Module Microsoft.Graph.Devices.CorporateManagement

$params = @{
	"@odata.type" = "#microsoft.graph.windowsAppX"
	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 = 
	applicableArchitectures = "x86"
	identityName = "Identity Name value"
	identityPublisherHash = "Identity Publisher Hash value"
	identityResourceIdentifier = "Identity Resource Identifier value"
	isBundle = $true
	minimumSupportedOperatingSystem = @{
		"@odata.type" = "microsoft.graph.windowsMinimumOperatingSystem"
		v8_0 = $true
		v8_1 = $true
		v10_0 = $true
	}
	identityVersion = "Identity Version value"
}

Update-MgDeviceAppManagementMobileApp -MobileAppId $mobileAppId -BodyParameter $params

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Python

from msgraph import GraphServiceClient
from msgraph.generated.models.windows_app_x import WindowsAppX
from msgraph.generated.models.mime_content import MimeContent
from msgraph.generated.models.windows_minimum_operating_system import WindowsMinimumOperatingSystem

graph_client = GraphServiceClient(credentials, scopes)

request_body = WindowsAppX(
	odata_type = "#microsoft.graph.windowsAppX",
	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,
	applicable_architectures = WindowsArchitecture.X86,
	identity_name = "Identity Name value",
	identity_publisher_hash = "Identity Publisher Hash value",
	identity_resource_identifier = "Identity Resource Identifier value",
	is_bundle = True,
	minimum_supported_operating_system = WindowsMinimumOperatingSystem(
		odata_type = "microsoft.graph.windowsMinimumOperatingSystem",
		v8_0 = True,
		v8_1 = True,
		v10_0 = True,
	),
	identity_version = "Identity Version value",
)

result = await graph_client.device_app_management.mobile_apps.by_mobile_app_id('mobileApp-id').patch(request_body)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1313

{
  "@odata.type": "#microsoft.graph.windowsAppX",
  "id": "b5179a93-9a93-b517-939a-17b5939a17b5",
  "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,
  "applicableArchitectures": "x86",
  "identityName": "Identity Name value",
  "identityPublisherHash": "Identity Publisher Hash value",
  "identityResourceIdentifier": "Identity Resource Identifier value",
  "isBundle": true,
  "minimumSupportedOperatingSystem": {
    "@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
    "v8_0": true,
    "v8_1": true,
    "v10_0": true
  },
  "identityVersion": "Identity Version value"
}