Update iosDeviceFeaturesConfiguration

名前空間: microsoft.graph

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

iosDeviceFeaturesConfiguration オブジェクトのプロパティを更新します。

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

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

アクセス許可

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

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

HTTP 要求

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

要求ヘッダー

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

要求本文

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

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

プロパティ	型	説明
id	String	エンティティのキー。 deviceConfiguration から継承します
lastModifiedDateTime	DateTimeOffset	オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します
createdDateTime	DateTimeOffset	オブジェクトが作成された DateTime。 deviceConfiguration から継承します
description	String	管理者が指定した、デバイス構成についての説明。 deviceConfiguration から継承します
displayName	String	管理者が指定した、デバイス構成の名前。 deviceConfiguration から継承します
version	Int32	デバイス構成のバージョン。 deviceConfiguration から継承します
assetTagTemplate	String	ログイン ウィンドウとロック画面に表示される、デバイスの資産タグ情報です。
lockScreenFootnote	String	ログイン ウィンドウとロック画面に表示される脚注です。 IOS 9.3.1 以降で利用可能です。
homeScreenDockIcons	iosHomeScreenItem コレクション	ホーム画面ドックに表示されるアプリとフォルダーのリスト。 このコレクションには、最大で 500 個の要素を含めることができます。
homeScreenPages	iosHomeScreenPage コレクション	ホーム画面上のページのリスト。 このコレクションには、最大で 500 個の要素を含めることができます。
notificationSettings	iosNotificationSettings コレクション	各バンドル ID ごとの通知設定。監視モードのデバイスにのみ (iOS 9.3 以降) 適用されます。 このコレクションには、最大で 500 個の要素を含めることができます。

応答

このメソッドが成功した場合、このメソッドは 200 OK 応答コードと、更新された iosDeviceFeaturesConfiguration オブジェクトを応答本文で返します。

例

要求

以下は、要求の例です。

HTTP

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1988

{
  "@odata.type": "#microsoft.graph.iosDeviceFeaturesConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "assetTagTemplate": "Asset Tag Template value",
  "lockScreenFootnote": "Lock Screen Footnote value",
  "homeScreenDockIcons": [
    {
      "@odata.type": "microsoft.graph.iosHomeScreenFolder",
      "displayName": "Display Name value",
      "pages": [
        {
          "@odata.type": "microsoft.graph.iosHomeScreenFolderPage",
          "displayName": "Display Name value",
          "apps": [
            {
              "@odata.type": "microsoft.graph.iosHomeScreenApp",
              "displayName": "Display Name value",
              "bundleID": "Bundle ID value"
            }
          ]
        }
      ]
    }
  ],
  "homeScreenPages": [
    {
      "@odata.type": "microsoft.graph.iosHomeScreenPage",
      "displayName": "Display Name value",
      "icons": [
        {
          "@odata.type": "microsoft.graph.iosHomeScreenFolder",
          "displayName": "Display Name value",
          "pages": [
            {
              "@odata.type": "microsoft.graph.iosHomeScreenFolderPage",
              "displayName": "Display Name value",
              "apps": [
                {
                  "@odata.type": "microsoft.graph.iosHomeScreenApp",
                  "displayName": "Display Name value",
                  "bundleID": "Bundle ID value"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "notificationSettings": [
    {
      "@odata.type": "microsoft.graph.iosNotificationSettings",
      "bundleID": "Bundle ID value",
      "appName": "App Name value",
      "publisher": "Publisher value",
      "enabled": true,
      "showInNotificationCenter": true,
      "showOnLockScreen": true,
      "alertType": "banner",
      "badgesEnabled": true,
      "soundsEnabled": true
    }
  ]
}

C#

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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new IosDeviceFeaturesConfiguration
{
	OdataType = "#microsoft.graph.iosDeviceFeaturesConfiguration",
	Description = "Description value",
	DisplayName = "Display Name value",
	Version = 7,
	AssetTagTemplate = "Asset Tag Template value",
	LockScreenFootnote = "Lock Screen Footnote value",
	HomeScreenDockIcons = new List<IosHomeScreenItem>
	{
		new IosHomeScreenFolder
		{
			OdataType = "microsoft.graph.iosHomeScreenFolder",
			DisplayName = "Display Name value",
			Pages = new List<IosHomeScreenFolderPage>
			{
				new IosHomeScreenFolderPage
				{
					OdataType = "microsoft.graph.iosHomeScreenFolderPage",
					DisplayName = "Display Name value",
					Apps = new List<IosHomeScreenApp>
					{
						new IosHomeScreenApp
						{
							OdataType = "microsoft.graph.iosHomeScreenApp",
							DisplayName = "Display Name value",
							BundleID = "Bundle ID value",
						},
					},
				},
			},
		},
	},
	HomeScreenPages = new List<IosHomeScreenPage>
	{
		new IosHomeScreenPage
		{
			OdataType = "microsoft.graph.iosHomeScreenPage",
			DisplayName = "Display Name value",
			Icons = new List<IosHomeScreenItem>
			{
				new IosHomeScreenFolder
				{
					OdataType = "microsoft.graph.iosHomeScreenFolder",
					DisplayName = "Display Name value",
					Pages = new List<IosHomeScreenFolderPage>
					{
						new IosHomeScreenFolderPage
						{
							OdataType = "microsoft.graph.iosHomeScreenFolderPage",
							DisplayName = "Display Name value",
							Apps = new List<IosHomeScreenApp>
							{
								new IosHomeScreenApp
								{
									OdataType = "microsoft.graph.iosHomeScreenApp",
									DisplayName = "Display Name value",
									BundleID = "Bundle ID value",
								},
							},
						},
					},
				},
			},
		},
	},
	NotificationSettings = new List<IosNotificationSettings>
	{
		new IosNotificationSettings
		{
			OdataType = "microsoft.graph.iosNotificationSettings",
			BundleID = "Bundle ID value",
			AppName = "App Name value",
			Publisher = "Publisher value",
			Enabled = true,
			ShowInNotificationCenter = true,
			ShowOnLockScreen = true,
			AlertType = IosNotificationAlertType.Banner,
			BadgesEnabled = true,
			SoundsEnabled = true,
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DeviceConfigurations["{deviceConfiguration-id}"].PatchAsync(requestBody);

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

CLI

mgc device-management device-configurations patch --device-configuration-id {deviceConfiguration-id} --body '{\
  "@odata.type": "#microsoft.graph.iosDeviceFeaturesConfiguration",\
  "description": "Description value",\
  "displayName": "Display Name value",\
  "version": 7,\
  "assetTagTemplate": "Asset Tag Template value",\
  "lockScreenFootnote": "Lock Screen Footnote value",\
  "homeScreenDockIcons": [\
    {\
      "@odata.type": "microsoft.graph.iosHomeScreenFolder",\
      "displayName": "Display Name value",\
      "pages": [\
        {\
          "@odata.type": "microsoft.graph.iosHomeScreenFolderPage",\
          "displayName": "Display Name value",\
          "apps": [\
            {\
              "@odata.type": "microsoft.graph.iosHomeScreenApp",\
              "displayName": "Display Name value",\
              "bundleID": "Bundle ID value"\
            }\
          ]\
        }\
      ]\
    }\
  ],\
  "homeScreenPages": [\
    {\
      "@odata.type": "microsoft.graph.iosHomeScreenPage",\
      "displayName": "Display Name value",\
      "icons": [\
        {\
          "@odata.type": "microsoft.graph.iosHomeScreenFolder",\
          "displayName": "Display Name value",\
          "pages": [\
            {\
              "@odata.type": "microsoft.graph.iosHomeScreenFolderPage",\
              "displayName": "Display Name value",\
              "apps": [\
                {\
                  "@odata.type": "microsoft.graph.iosHomeScreenApp",\
                  "displayName": "Display Name value",\
                  "bundleID": "Bundle ID value"\
                }\
              ]\
            }\
          ]\
        }\
      ]\
    }\
  ],\
  "notificationSettings": [\
    {\
      "@odata.type": "microsoft.graph.iosNotificationSettings",\
      "bundleID": "Bundle ID value",\
      "appName": "App Name value",\
      "publisher": "Publisher value",\
      "enabled": true,\
      "showInNotificationCenter": true,\
      "showOnLockScreen": true,\
      "alertType": "banner",\
      "badgesEnabled": true,\
      "soundsEnabled": true\
    }\
  ]\
}\
'

プロジェクトに 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.NewDeviceConfiguration()
description := "Description value"
requestBody.SetDescription(&description) 
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
version := int32(7)
requestBody.SetVersion(&version) 
assetTagTemplate := "Asset Tag Template value"
requestBody.SetAssetTagTemplate(&assetTagTemplate) 
lockScreenFootnote := "Lock Screen Footnote value"
requestBody.SetLockScreenFootnote(&lockScreenFootnote) 


iosHomeScreenItem := graphmodels.NewIosHomeScreenFolder()
displayName := "Display Name value"
iosHomeScreenItem.SetDisplayName(&displayName) 


iosHomeScreenFolderPage := graphmodels.NewIosHomeScreenFolderPage()
displayName := "Display Name value"
iosHomeScreenFolderPage.SetDisplayName(&displayName) 


iosHomeScreenApp := graphmodels.NewIosHomeScreenApp()
displayName := "Display Name value"
iosHomeScreenApp.SetDisplayName(&displayName) 
bundleID := "Bundle ID value"
iosHomeScreenApp.SetBundleID(&bundleID) 

apps := []graphmodels.IosHomeScreenAppable {
	iosHomeScreenApp,
}
iosHomeScreenFolderPage.SetApps(apps)

pages := []graphmodels.IosHomeScreenFolderPageable {
	iosHomeScreenFolderPage,
}
iosHomeScreenItem.SetPages(pages)

homeScreenDockIcons := []graphmodels.IosHomeScreenItemable {
	iosHomeScreenItem,
}
requestBody.SetHomeScreenDockIcons(homeScreenDockIcons)


iosHomeScreenPage := graphmodels.NewIosHomeScreenPage()
displayName := "Display Name value"
iosHomeScreenPage.SetDisplayName(&displayName) 


iosHomeScreenItem := graphmodels.NewIosHomeScreenFolder()
displayName := "Display Name value"
iosHomeScreenItem.SetDisplayName(&displayName) 


iosHomeScreenFolderPage := graphmodels.NewIosHomeScreenFolderPage()
displayName := "Display Name value"
iosHomeScreenFolderPage.SetDisplayName(&displayName) 


iosHomeScreenApp := graphmodels.NewIosHomeScreenApp()
displayName := "Display Name value"
iosHomeScreenApp.SetDisplayName(&displayName) 
bundleID := "Bundle ID value"
iosHomeScreenApp.SetBundleID(&bundleID) 

apps := []graphmodels.IosHomeScreenAppable {
	iosHomeScreenApp,
}
iosHomeScreenFolderPage.SetApps(apps)

pages := []graphmodels.IosHomeScreenFolderPageable {
	iosHomeScreenFolderPage,
}
iosHomeScreenItem.SetPages(pages)

icons := []graphmodels.IosHomeScreenItemable {
	iosHomeScreenItem,
}
iosHomeScreenPage.SetIcons(icons)

homeScreenPages := []graphmodels.IosHomeScreenPageable {
	iosHomeScreenPage,
}
requestBody.SetHomeScreenPages(homeScreenPages)


iosNotificationSettings := graphmodels.NewIosNotificationSettings()
bundleID := "Bundle ID value"
iosNotificationSettings.SetBundleID(&bundleID) 
appName := "App Name value"
iosNotificationSettings.SetAppName(&appName) 
publisher := "Publisher value"
iosNotificationSettings.SetPublisher(&publisher) 
enabled := true
iosNotificationSettings.SetEnabled(&enabled) 
showInNotificationCenter := true
iosNotificationSettings.SetShowInNotificationCenter(&showInNotificationCenter) 
showOnLockScreen := true
iosNotificationSettings.SetShowOnLockScreen(&showOnLockScreen) 
alertType := graphmodels.BANNER_IOSNOTIFICATIONALERTTYPE 
iosNotificationSettings.SetAlertType(&alertType) 
badgesEnabled := true
iosNotificationSettings.SetBadgesEnabled(&badgesEnabled) 
soundsEnabled := true
iosNotificationSettings.SetSoundsEnabled(&soundsEnabled) 

notificationSettings := []graphmodels.IosNotificationSettingsable {
	iosNotificationSettings,
}
requestBody.SetNotificationSettings(notificationSettings)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
deviceConfigurations, err := graphClient.DeviceManagement().DeviceConfigurations().ByDeviceConfigurationId("deviceConfiguration-id").Patch(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);

IosDeviceFeaturesConfiguration deviceConfiguration = new IosDeviceFeaturesConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.iosDeviceFeaturesConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
deviceConfiguration.setAssetTagTemplate("Asset Tag Template value");
deviceConfiguration.setLockScreenFootnote("Lock Screen Footnote value");
LinkedList<IosHomeScreenItem> homeScreenDockIcons = new LinkedList<IosHomeScreenItem>();
IosHomeScreenFolder iosHomeScreenItem = new IosHomeScreenFolder();
iosHomeScreenItem.setOdataType("microsoft.graph.iosHomeScreenFolder");
iosHomeScreenItem.setDisplayName("Display Name value");
LinkedList<IosHomeScreenFolderPage> pages = new LinkedList<IosHomeScreenFolderPage>();
IosHomeScreenFolderPage iosHomeScreenFolderPage = new IosHomeScreenFolderPage();
iosHomeScreenFolderPage.setOdataType("microsoft.graph.iosHomeScreenFolderPage");
iosHomeScreenFolderPage.setDisplayName("Display Name value");
LinkedList<IosHomeScreenApp> apps = new LinkedList<IosHomeScreenApp>();
IosHomeScreenApp iosHomeScreenApp = new IosHomeScreenApp();
iosHomeScreenApp.setOdataType("microsoft.graph.iosHomeScreenApp");
iosHomeScreenApp.setDisplayName("Display Name value");
iosHomeScreenApp.setBundleID("Bundle ID value");
apps.add(iosHomeScreenApp);
iosHomeScreenFolderPage.setApps(apps);
pages.add(iosHomeScreenFolderPage);
iosHomeScreenItem.setPages(pages);
homeScreenDockIcons.add(iosHomeScreenItem);
deviceConfiguration.setHomeScreenDockIcons(homeScreenDockIcons);
LinkedList<IosHomeScreenPage> homeScreenPages = new LinkedList<IosHomeScreenPage>();
IosHomeScreenPage iosHomeScreenPage = new IosHomeScreenPage();
iosHomeScreenPage.setOdataType("microsoft.graph.iosHomeScreenPage");
iosHomeScreenPage.setDisplayName("Display Name value");
LinkedList<IosHomeScreenItem> icons = new LinkedList<IosHomeScreenItem>();
IosHomeScreenFolder iosHomeScreenItem1 = new IosHomeScreenFolder();
iosHomeScreenItem1.setOdataType("microsoft.graph.iosHomeScreenFolder");
iosHomeScreenItem1.setDisplayName("Display Name value");
LinkedList<IosHomeScreenFolderPage> pages1 = new LinkedList<IosHomeScreenFolderPage>();
IosHomeScreenFolderPage iosHomeScreenFolderPage1 = new IosHomeScreenFolderPage();
iosHomeScreenFolderPage1.setOdataType("microsoft.graph.iosHomeScreenFolderPage");
iosHomeScreenFolderPage1.setDisplayName("Display Name value");
LinkedList<IosHomeScreenApp> apps1 = new LinkedList<IosHomeScreenApp>();
IosHomeScreenApp iosHomeScreenApp1 = new IosHomeScreenApp();
iosHomeScreenApp1.setOdataType("microsoft.graph.iosHomeScreenApp");
iosHomeScreenApp1.setDisplayName("Display Name value");
iosHomeScreenApp1.setBundleID("Bundle ID value");
apps1.add(iosHomeScreenApp1);
iosHomeScreenFolderPage1.setApps(apps1);
pages1.add(iosHomeScreenFolderPage1);
iosHomeScreenItem1.setPages(pages1);
icons.add(iosHomeScreenItem1);
iosHomeScreenPage.setIcons(icons);
homeScreenPages.add(iosHomeScreenPage);
deviceConfiguration.setHomeScreenPages(homeScreenPages);
LinkedList<IosNotificationSettings> notificationSettings = new LinkedList<IosNotificationSettings>();
IosNotificationSettings iosNotificationSettings = new IosNotificationSettings();
iosNotificationSettings.setOdataType("microsoft.graph.iosNotificationSettings");
iosNotificationSettings.setBundleID("Bundle ID value");
iosNotificationSettings.setAppName("App Name value");
iosNotificationSettings.setPublisher("Publisher value");
iosNotificationSettings.setEnabled(true);
iosNotificationSettings.setShowInNotificationCenter(true);
iosNotificationSettings.setShowOnLockScreen(true);
iosNotificationSettings.setAlertType(IosNotificationAlertType.Banner);
iosNotificationSettings.setBadgesEnabled(true);
iosNotificationSettings.setSoundsEnabled(true);
notificationSettings.add(iosNotificationSettings);
deviceConfiguration.setNotificationSettings(notificationSettings);
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().byDeviceConfigurationId("{deviceConfiguration-id}").patch(deviceConfiguration);

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

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const deviceConfiguration = {
  '@odata.type': '#microsoft.graph.iosDeviceFeaturesConfiguration',
  description: 'Description value',
  displayName: 'Display Name value',
  version: 7,
  assetTagTemplate: 'Asset Tag Template value',
  lockScreenFootnote: 'Lock Screen Footnote value',
  homeScreenDockIcons: [
    {
      '@odata.type': 'microsoft.graph.iosHomeScreenFolder',
      displayName: 'Display Name value',
      pages: [
        {
          '@odata.type': 'microsoft.graph.iosHomeScreenFolderPage',
          displayName: 'Display Name value',
          apps: [
            {
              '@odata.type': 'microsoft.graph.iosHomeScreenApp',
              displayName: 'Display Name value',
              bundleID: 'Bundle ID value'
            }
          ]
        }
      ]
    }
  ],
  homeScreenPages: [
    {
      '@odata.type': 'microsoft.graph.iosHomeScreenPage',
      displayName: 'Display Name value',
      icons: [
        {
          '@odata.type': 'microsoft.graph.iosHomeScreenFolder',
          displayName: 'Display Name value',
          pages: [
            {
              '@odata.type': 'microsoft.graph.iosHomeScreenFolderPage',
              displayName: 'Display Name value',
              apps: [
                {
                  '@odata.type': 'microsoft.graph.iosHomeScreenApp',
                  displayName: 'Display Name value',
                  bundleID: 'Bundle ID value'
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  notificationSettings: [
    {
      '@odata.type': 'microsoft.graph.iosNotificationSettings',
      bundleID: 'Bundle ID value',
      appName: 'App Name value',
      publisher: 'Publisher value',
      enabled: true,
      showInNotificationCenter: true,
      showOnLockScreen: true,
      alertType: 'banner',
      badgesEnabled: true,
      soundsEnabled: true
    }
  ]
};

await client.api('/deviceManagement/deviceConfigurations/{deviceConfigurationId}')
	.update(deviceConfiguration);

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

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\IosDeviceFeaturesConfiguration;
use Microsoft\Graph\Generated\Models\IosHomeScreenItem;
use Microsoft\Graph\Generated\Models\IosHomeScreenFolder;
use Microsoft\Graph\Generated\Models\IosHomeScreenFolderPage;
use Microsoft\Graph\Generated\Models\IosHomeScreenApp;
use Microsoft\Graph\Generated\Models\IosHomeScreenPage;
use Microsoft\Graph\Generated\Models\IosNotificationSettings;
use Microsoft\Graph\Generated\Models\IosNotificationAlertType;


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

$requestBody = new IosDeviceFeaturesConfiguration();
$requestBody->setOdataType('#microsoft.graph.iosDeviceFeaturesConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$requestBody->setAssetTagTemplate('Asset Tag Template value');
$requestBody->setLockScreenFootnote('Lock Screen Footnote value');
$homeScreenDockIconsIosHomeScreenItem1 = new IosHomeScreenFolder();
$homeScreenDockIconsIosHomeScreenItem1->setOdataType('microsoft.graph.iosHomeScreenFolder');
$homeScreenDockIconsIosHomeScreenItem1->setDisplayName('Display Name value');
$pagesIosHomeScreenFolderPage1 = new IosHomeScreenFolderPage();
$pagesIosHomeScreenFolderPage1->setOdataType('microsoft.graph.iosHomeScreenFolderPage');
$pagesIosHomeScreenFolderPage1->setDisplayName('Display Name value');
$appsIosHomeScreenApp1 = new IosHomeScreenApp();
$appsIosHomeScreenApp1->setOdataType('microsoft.graph.iosHomeScreenApp');
$appsIosHomeScreenApp1->setDisplayName('Display Name value');
$appsIosHomeScreenApp1->setBundleID('Bundle ID value');
$appsArray []= $appsIosHomeScreenApp1;
$pagesIosHomeScreenFolderPage1->setApps($appsArray);

$pagesArray []= $pagesIosHomeScreenFolderPage1;
$homeScreenDockIconsIosHomeScreenItem1->setPages($pagesArray);

$homeScreenDockIconsArray []= $homeScreenDockIconsIosHomeScreenItem1;
$requestBody->setHomeScreenDockIcons($homeScreenDockIconsArray);

$homeScreenPagesIosHomeScreenPage1 = new IosHomeScreenPage();
$homeScreenPagesIosHomeScreenPage1->setOdataType('microsoft.graph.iosHomeScreenPage');
$homeScreenPagesIosHomeScreenPage1->setDisplayName('Display Name value');
$iconsIosHomeScreenItem1 = new IosHomeScreenFolder();
$iconsIosHomeScreenItem1->setOdataType('microsoft.graph.iosHomeScreenFolder');
$iconsIosHomeScreenItem1->setDisplayName('Display Name value');
$pagesIosHomeScreenFolderPage1 = new IosHomeScreenFolderPage();
$pagesIosHomeScreenFolderPage1->setOdataType('microsoft.graph.iosHomeScreenFolderPage');
$pagesIosHomeScreenFolderPage1->setDisplayName('Display Name value');
$appsIosHomeScreenApp1 = new IosHomeScreenApp();
$appsIosHomeScreenApp1->setOdataType('microsoft.graph.iosHomeScreenApp');
$appsIosHomeScreenApp1->setDisplayName('Display Name value');
$appsIosHomeScreenApp1->setBundleID('Bundle ID value');
$appsArray []= $appsIosHomeScreenApp1;
$pagesIosHomeScreenFolderPage1->setApps($appsArray);

$pagesArray []= $pagesIosHomeScreenFolderPage1;
$iconsIosHomeScreenItem1->setPages($pagesArray);

$iconsArray []= $iconsIosHomeScreenItem1;
$homeScreenPagesIosHomeScreenPage1->setIcons($iconsArray);

$homeScreenPagesArray []= $homeScreenPagesIosHomeScreenPage1;
$requestBody->setHomeScreenPages($homeScreenPagesArray);

$notificationSettingsIosNotificationSettings1 = new IosNotificationSettings();
$notificationSettingsIosNotificationSettings1->setOdataType('microsoft.graph.iosNotificationSettings');
$notificationSettingsIosNotificationSettings1->setBundleID('Bundle ID value');
$notificationSettingsIosNotificationSettings1->setAppName('App Name value');
$notificationSettingsIosNotificationSettings1->setPublisher('Publisher value');
$notificationSettingsIosNotificationSettings1->setEnabled(true);
$notificationSettingsIosNotificationSettings1->setShowInNotificationCenter(true);
$notificationSettingsIosNotificationSettings1->setShowOnLockScreen(true);
$notificationSettingsIosNotificationSettings1->setAlertType(new IosNotificationAlertType('banner'));
$notificationSettingsIosNotificationSettings1->setBadgesEnabled(true);
$notificationSettingsIosNotificationSettings1->setSoundsEnabled(true);
$notificationSettingsArray []= $notificationSettingsIosNotificationSettings1;
$requestBody->setNotificationSettings($notificationSettingsArray);


$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->byDeviceConfigurationId('deviceConfiguration-id')->patch($requestBody)->wait();

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

PowerShell

Import-Module Microsoft.Graph.DeviceManagement

$params = @{
	"@odata.type" = "#microsoft.graph.iosDeviceFeaturesConfiguration"
	description = "Description value"
	displayName = "Display Name value"
	version = 7
	assetTagTemplate = "Asset Tag Template value"
	lockScreenFootnote = "Lock Screen Footnote value"
	homeScreenDockIcons = @(
		@{
			"@odata.type" = "microsoft.graph.iosHomeScreenFolder"
			displayName = "Display Name value"
			pages = @(
				@{
					"@odata.type" = "microsoft.graph.iosHomeScreenFolderPage"
					displayName = "Display Name value"
					apps = @(
						@{
							"@odata.type" = "microsoft.graph.iosHomeScreenApp"
							displayName = "Display Name value"
							bundleID = "Bundle ID value"
						}
					)
				}
			)
		}
	)
	homeScreenPages = @(
		@{
			"@odata.type" = "microsoft.graph.iosHomeScreenPage"
			displayName = "Display Name value"
			icons = @(
				@{
					"@odata.type" = "microsoft.graph.iosHomeScreenFolder"
					displayName = "Display Name value"
					pages = @(
						@{
							"@odata.type" = "microsoft.graph.iosHomeScreenFolderPage"
							displayName = "Display Name value"
							apps = @(
								@{
									"@odata.type" = "microsoft.graph.iosHomeScreenApp"
									displayName = "Display Name value"
									bundleID = "Bundle ID value"
								}
							)
						}
					)
				}
			)
		}
	)
	notificationSettings = @(
		@{
			"@odata.type" = "microsoft.graph.iosNotificationSettings"
			bundleID = "Bundle ID value"
			appName = "App Name value"
			publisher = "Publisher value"
			enabled = $true
			showInNotificationCenter = $true
			showOnLockScreen = $true
			alertType = "banner"
			badgesEnabled = $true
			soundsEnabled = $true
		}
	)
}

Update-MgDeviceManagementDeviceConfiguration -DeviceConfigurationId $deviceConfigurationId -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.ios_device_features_configuration import IosDeviceFeaturesConfiguration
from msgraph.generated.models.ios_home_screen_item import IosHomeScreenItem
from msgraph.generated.models.ios_home_screen_folder import IosHomeScreenFolder
from msgraph.generated.models.ios_home_screen_folder_page import IosHomeScreenFolderPage
from msgraph.generated.models.ios_home_screen_app import IosHomeScreenApp
from msgraph.generated.models.ios_home_screen_page import IosHomeScreenPage
from msgraph.generated.models.ios_notification_settings import IosNotificationSettings
from msgraph.generated.models.ios_notification_alert_type import IosNotificationAlertType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = IosDeviceFeaturesConfiguration(
	odata_type = "#microsoft.graph.iosDeviceFeaturesConfiguration",
	description = "Description value",
	display_name = "Display Name value",
	version = 7,
	asset_tag_template = "Asset Tag Template value",
	lock_screen_footnote = "Lock Screen Footnote value",
	home_screen_dock_icons = [
		IosHomeScreenFolder(
			odata_type = "microsoft.graph.iosHomeScreenFolder",
			display_name = "Display Name value",
			pages = [
				IosHomeScreenFolderPage(
					odata_type = "microsoft.graph.iosHomeScreenFolderPage",
					display_name = "Display Name value",
					apps = [
						IosHomeScreenApp(
							odata_type = "microsoft.graph.iosHomeScreenApp",
							display_name = "Display Name value",
							bundle_i_d = "Bundle ID value",
						),
					],
				),
			],
		),
	],
	home_screen_pages = [
		IosHomeScreenPage(
			odata_type = "microsoft.graph.iosHomeScreenPage",
			display_name = "Display Name value",
			icons = [
				IosHomeScreenFolder(
					odata_type = "microsoft.graph.iosHomeScreenFolder",
					display_name = "Display Name value",
					pages = [
						IosHomeScreenFolderPage(
							odata_type = "microsoft.graph.iosHomeScreenFolderPage",
							display_name = "Display Name value",
							apps = [
								IosHomeScreenApp(
									odata_type = "microsoft.graph.iosHomeScreenApp",
									display_name = "Display Name value",
									bundle_i_d = "Bundle ID value",
								),
							],
						),
					],
				),
			],
		),
	],
	notification_settings = [
		IosNotificationSettings(
			odata_type = "microsoft.graph.iosNotificationSettings",
			bundle_i_d = "Bundle ID value",
			app_name = "App Name value",
			publisher = "Publisher value",
			enabled = True,
			show_in_notification_center = True,
			show_on_lock_screen = True,
			alert_type = IosNotificationAlertType.Banner,
			badges_enabled = True,
			sounds_enabled = True,
		),
	],
)

result = await graph_client.device_management.device_configurations.by_device_configuration_id('deviceConfiguration-id').patch(request_body)

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

応答

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

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

{
  "@odata.type": "#microsoft.graph.iosDeviceFeaturesConfiguration",
  "id": "651e0ab3-0ab3-651e-b30a-1e65b30a1e65",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "assetTagTemplate": "Asset Tag Template value",
  "lockScreenFootnote": "Lock Screen Footnote value",
  "homeScreenDockIcons": [
    {
      "@odata.type": "microsoft.graph.iosHomeScreenFolder",
      "displayName": "Display Name value",
      "pages": [
        {
          "@odata.type": "microsoft.graph.iosHomeScreenFolderPage",
          "displayName": "Display Name value",
          "apps": [
            {
              "@odata.type": "microsoft.graph.iosHomeScreenApp",
              "displayName": "Display Name value",
              "bundleID": "Bundle ID value"
            }
          ]
        }
      ]
    }
  ],
  "homeScreenPages": [
    {
      "@odata.type": "microsoft.graph.iosHomeScreenPage",
      "displayName": "Display Name value",
      "icons": [
        {
          "@odata.type": "microsoft.graph.iosHomeScreenFolder",
          "displayName": "Display Name value",
          "pages": [
            {
              "@odata.type": "microsoft.graph.iosHomeScreenFolderPage",
              "displayName": "Display Name value",
              "apps": [
                {
                  "@odata.type": "microsoft.graph.iosHomeScreenApp",
                  "displayName": "Display Name value",
                  "bundleID": "Bundle ID value"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "notificationSettings": [
    {
      "@odata.type": "microsoft.graph.iosNotificationSettings",
      "bundleID": "Bundle ID value",
      "appName": "App Name value",
      "publisher": "Publisher value",
      "enabled": true,
      "showInNotificationCenter": true,
      "showOnLockScreen": true,
      "alertType": "banner",
      "badgesEnabled": true,
      "soundsEnabled": true
    }
  ]
}