Actualizar microsoftStoreForBusinessApp
Artículo 08/01/2024
13 colaboradores
Comentarios
En este artículo
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 microsoftStoreForBusinessApp .
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}
Cuerpo de la solicitud
En el cuerpo de la solicitud, especifique una representación JSON del objeto microsoftStoreForBusinessApp .
En la tabla siguiente se muestran las propiedades necesarias para crear el objeto microsoftStoreForBusinessApp .
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
.
usedLicenseCount
Int32
Número de licencias de Microsoft Store para Empresas en uso.
totalLicenseCount
Int32
Número total de licencias de Microsoft Store para Empresas.
productKey
Cadena
Clave de producto de la aplicación
licenseType
microsoftStoreForBusinessLicenseType
Tipo de licencia de la aplicación. Los valores posibles son offline
y online
.
packageIdentityName
Cadena
Identificador del paquete de aplicación.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK
y un objeto microsoftStoreForBusinessApp actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 769
{
"@odata.type": "#microsoft.graph.microsoftStoreForBusinessApp",
"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",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"productKey": "Product Key value",
"licenseType": "online",
"packageIdentityName": "Package Identity Name value"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new MicrosoftStoreForBusinessApp
{
OdataType = "#microsoft.graph.microsoftStoreForBusinessApp",
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,
UsedLicenseCount = 0,
TotalLicenseCount = 1,
ProductKey = "Product Key value",
LicenseType = MicrosoftStoreForBusinessLicenseType.Online,
PackageIdentityName = "Package Identity Name value",
};
// To initialize your graphClient, see https://zcusa.951200.xyz/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 .
mgc device-app-management mobile-apps patch --mobile-app-id {mobileApp-id} --body '{\
"@odata.type": "#microsoft.graph.microsoftStoreForBusinessApp",\
"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",\
"usedLicenseCount": 0,\
"totalLicenseCount": 1,\
"productKey": "Product Key value",\
"licenseType": "online",\
"packageIdentityName": "Package Identity Name 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 .
// 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)
usedLicenseCount := int32(0)
requestBody.SetUsedLicenseCount(&usedLicenseCount)
totalLicenseCount := int32(1)
requestBody.SetTotalLicenseCount(&totalLicenseCount)
productKey := "Product Key value"
requestBody.SetProductKey(&productKey)
licenseType := graphmodels.ONLINE_MICROSOFTSTOREFORBUSINESSLICENSETYPE
requestBody.SetLicenseType(&licenseType)
packageIdentityName := "Package Identity Name value"
requestBody.SetPackageIdentityName(&packageIdentityName)
// To initialize your graphClient, see https://zcusa.951200.xyz/en-us/graph/sdks/create-client?from=snippets&tabs=go
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 .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
MicrosoftStoreForBusinessApp mobileApp = new MicrosoftStoreForBusinessApp();
mobileApp.setOdataType("#microsoft.graph.microsoftStoreForBusinessApp");
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.setUsedLicenseCount(0);
mobileApp.setTotalLicenseCount(1);
mobileApp.setProductKey("Product Key value");
mobileApp.setLicenseType(MicrosoftStoreForBusinessLicenseType.Online);
mobileApp.setPackageIdentityName("Package Identity Name 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 .
const options = {
authProvider,
};
const client = Client.init(options);
const mobileApp = {
'@odata.type': '#microsoft.graph.microsoftStoreForBusinessApp',
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',
usedLicenseCount: 0,
totalLicenseCount: 1,
productKey: 'Product Key value',
licenseType: 'online',
packageIdentityName: 'Package Identity Name 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
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\MicrosoftStoreForBusinessApp;
use Microsoft\Graph\Generated\Models\MimeContent;
use Microsoft\Graph\Generated\Models\MobileAppPublishingState;
use Microsoft\Graph\Generated\Models\MicrosoftStoreForBusinessLicenseType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new MicrosoftStoreForBusinessApp();
$requestBody->setOdataType('#microsoft.graph.microsoftStoreForBusinessApp');
$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->setUsedLicenseCount(0);
$requestBody->setTotalLicenseCount(1);
$requestBody->setProductKey('Product Key value');
$requestBody->setLicenseType(new MicrosoftStoreForBusinessLicenseType('online'));
$requestBody->setPackageIdentityName('Package Identity Name 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 .
Import-Module Microsoft.Graph.Devices.CorporateManagement
$params = @{
"@odata.type" = "#microsoft.graph.microsoftStoreForBusinessApp"
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"
usedLicenseCount =
totalLicenseCount =
productKey = "Product Key value"
licenseType = "online"
packageIdentityName = "Package Identity Name 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 .
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.microsoft_store_for_business_app import MicrosoftStoreForBusinessApp
from msgraph.generated.models.mime_content import MimeContent
from msgraph.generated.models.mobile_app_publishing_state import MobileAppPublishingState
from msgraph.generated.models.microsoft_store_for_business_license_type import MicrosoftStoreForBusinessLicenseType
# To initialize your graph_client, see https://zcusa.951200.xyz/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = MicrosoftStoreForBusinessApp(
odata_type = "#microsoft.graph.microsoftStoreForBusinessApp",
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,
used_license_count = 0,
total_license_count = 1,
product_key = "Product Key value",
license_type = MicrosoftStoreForBusinessLicenseType.Online,
package_identity_name = "Package Identity Name 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: 941
{
"@odata.type": "#microsoft.graph.microsoftStoreForBusinessApp",
"id": "f33358bc-58bc-f333-bc58-33f3bc5833f3",
"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",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"productKey": "Product Key value",
"licenseType": "online",
"packageIdentityName": "Package Identity Name value"
}