Create windowsUniversalAppX

名前空間: microsoft.graph

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

新しい windowsUniversalAppX オブジェクトを作成します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	DeviceManagementApps.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementApps.ReadWrite.All

HTTP 要求

POST /deviceAppManagement/mobileApps

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
承諾	application/json

要求本文

要求本文で、windowsUniversalAppX オブジェクトの JSON 表現を指定します。

次の表に、windowsUniversalAppX の作成時に必要なプロパティを示します。

プロパティ	型	説明
id	String	エンティティのキー。 mobileApp から継承します
displayName	String	管理者が提供またはインポートしたアプリのタイトル。 mobileApp から継承します
description	String	アプリの説明。 mobileApp から継承します
publisher	String	アプリの発行元。 mobileApp から継承します
largeIcon	mimeContent	アプリの詳細に表示され、アイコンのアップロードに使用される大きいアイコン。 mobileApp から継承します
createdDateTime	DateTimeOffset	アプリが作成された日時。 mobileApp から継承します
lastModifiedDateTime	DateTimeOffset	アプリが最後に変更された日時。 mobileApp から継承します
isFeatured	Boolean	アプリが管理者のおすすめとしてマークされたかどうかを示す値。mobileApp から継承します
privacyInformationUrl	String	プライバシーに関する声明の URL。 mobileApp から継承します
informationUrl	String	詳細情報の URL。 mobileApp から継承します
owner	String	アプリの所有者。 mobileApp から継承します
developer	String	アプリの開発者。 mobileApp から継承します
notes	String	アプリ用のメモ。 mobileApp から継承します
publishingState	mobileAppPublishingState	アプリの発行の状態。 アプリが発行されていない限り、アプリを割り当てることができません。 mobileApp から継承されます。 可能な値は notPublished、processing、published です。
committedContentVersion	String	内部にコミットされたコンテンツのバージョン。 mobileLobApp から継承します
fileName	String	メインの LOB アプリケーションのファイル名。 mobileLobApp から継承します
size	Int64	アップロードされたすべてのファイルを含む合計サイズ。 mobileLobApp から継承します
applicableArchitectures	windowsArchitecture	このアプリを実行できる Windows アーキテクチャ。 可能な値は、none、x86、x64、arm、neutral です。
applicableDeviceTypes	windowsDeviceType	このアプリを実行できる Windows デバイスの種類。 可能な値は、none、desktop、mobile、holographic、team です。
identityName	String	ID 名。
identityPublisherHash	String	ID の発行元のハッシュ。
identityResourceIdentifier	String	ID のリソースの識別子。
isBundle	Boolean	アプリがバンドルかどうかを指定します。
minimumSupportedOperatingSystem	windowsMinimumOperatingSystem	該当するオペレーティング システムの最小の値。
identityVersion	String	ID のバージョン。

応答

成功した場合、このメソッドは 201 Created 応答コードと、応答本文で windowsUniversalAppX オブジェクトを返します。

例

要求

以下は、要求の例です。

HTTP

POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1189

{
  "@odata.type": "#microsoft.graph.windowsUniversalAppX",
  "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",
  "applicableDeviceTypes": "desktop",
  "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 WindowsUniversalAppX
{
	OdataType = "#microsoft.graph.windowsUniversalAppX",
	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,
	ApplicableDeviceTypes = WindowsDeviceType.Desktop,
	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.PostAsync(requestBody);

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

CLI

mgc device-app-management mobile-apps create --body '{\
  "@odata.type": "#microsoft.graph.windowsUniversalAppX",\
  "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",\
  "applicableDeviceTypes": "desktop",\
  "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"\
}\
'

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Go

// 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(&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) 
applicableDeviceTypes := graphmodels.DESKTOP_WINDOWSDEVICETYPE 
requestBody.SetApplicableDeviceTypes(&applicableDeviceTypes) 
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) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
mobileApps, err := graphClient.DeviceAppManagement().MobileApps().Post(context.Background(), requestBody, nil)

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

WindowsUniversalAppX mobileApp = new WindowsUniversalAppX();
mobileApp.setOdataType("#microsoft.graph.windowsUniversalAppX");
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.setApplicableDeviceTypes(EnumSet.of(WindowsDeviceType.Desktop));
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().post(mobileApp);

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const mobileApp = {
  '@odata.type': '#microsoft.graph.windowsUniversalAppX',
  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',
  applicableDeviceTypes: 'desktop',
  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')
	.post(mobileApp);

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsUniversalAppX;
use Microsoft\Graph\Generated\Models\MimeContent;
use Microsoft\Graph\Generated\Models\MobileAppPublishingState;
use Microsoft\Graph\Generated\Models\WindowsArchitecture;
use Microsoft\Graph\Generated\Models\WindowsDeviceType;
use Microsoft\Graph\Generated\Models\WindowsMinimumOperatingSystem;


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

$requestBody = new WindowsUniversalAppX();
$requestBody->setOdataType('#microsoft.graph.windowsUniversalAppX');
$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->setApplicableDeviceTypes(new WindowsDeviceType('desktop'));
$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()->post($requestBody)->wait();

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

PowerShell

Import-Module Microsoft.Graph.Devices.CorporateManagement

$params = @{
	"@odata.type" = "#microsoft.graph.windowsUniversalAppX"
	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"
	applicableDeviceTypes = "desktop"
	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"
}

New-MgDeviceAppManagementMobileApp -BodyParameter $params

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.windows_universal_app_x import WindowsUniversalAppX
from msgraph.generated.models.mime_content import MimeContent
from msgraph.generated.models.mobile_app_publishing_state import MobileAppPublishingState
from msgraph.generated.models.windows_architecture import WindowsArchitecture
from msgraph.generated.models.windows_device_type import WindowsDeviceType
from msgraph.generated.models.windows_minimum_operating_system import WindowsMinimumOperatingSystem
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = WindowsUniversalAppX(
	odata_type = "#microsoft.graph.windowsUniversalAppX",
	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,
	applicable_device_types = WindowsDeviceType.Desktop,
	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.post(request_body)

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1361

{
  "@odata.type": "#microsoft.graph.windowsUniversalAppX",
  "id": "4bc47eba-7eba-4bc4-ba7e-c44bba7ec44b",
  "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",
  "applicableDeviceTypes": "desktop",
  "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"
}