次の方法で共有


windowsUpdateForBusinessConfiguration の更新

名前空間: microsoft.graph

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

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

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

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

アクセス許可

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

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

HTTP 要求

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

要求ヘッダー

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

要求本文

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

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

プロパティ 説明
id String エンティティのキー。 deviceConfiguration から継承します
lastModifiedDateTime DateTimeOffset オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します
createdDateTime DateTimeOffset オブジェクトが作成された DateTime。 deviceConfiguration から継承します
description String 管理者が指定した、デバイス構成についての説明。 deviceConfiguration から継承します
displayName String 管理者が指定した、デバイス構成の名前。 deviceConfiguration から継承します
version Int32 デバイス構成のバージョン。 deviceConfiguration から継承します
deliveryOptimizationMode windowsDeliveryOptimizationMode 配信最適化モード。 使用可能な値は、UserDefined、HttpOnly、HttpWithPeeringNat、HttpWithPeeringPrivateGroup、HttpWithInternetPeering、SimpleDownload、BypassMode です。 UserDefined を使用すると、ユーザーが設定できます。 既定で返されます。 クエリ パラメーターはサポートされていません。 可能な値は、userDefinedhttpOnlyhttpWithPeeringNathttpWithPeeringPrivateGrouphttpWithInternetPeeringsimpleDownloadbypassMode です。
prereleaseFeatures prereleaseFeatures プレリリース機能。 使用可能な値は、UserDefined、SettingsOnly、SettingsAndExperimentations、NotAllowed です。 UserDefined は既定値であり、意図はありません。 既定で返されます。 クエリ パラメーターはサポートされていません。 使用可能な値: userDefinedsettingsOnlysettingsAndExperimentationsnotAllowed
automaticUpdateMode automaticUpdateMode 自動更新モード。 指定できる値は、UserDefined、NotifyDownload、AutoInstallAtMaintenanceTime、AutoInstallAndRebootAtMaintenanceTime、AutoInstallAndRebootAtScheduledTime、AutoInstallAndRebootWithoutEndUserControl、WindowsDefault です。 UserDefined は既定値であり、意図はありません。 既定で返されます。 クエリ パラメーターはサポートされていません。 使用可能な値: userDefinednotifyDownloadautoInstallAtMaintenanceTimeautoInstallAndRebootAtMaintenanceTimeautoInstallAndRebootAtScheduledTimeautoInstallAndRebootWithoutEndUserControl
microsoftUpdateServiceAllowed ブール型 TRUE の場合、Microsoft Update Service が許可されます。 FALSE の場合、Microsoft Update Service は許可されません。 既定で返されます。 クエリ パラメーターはサポートされていません。
driversExcluded ブール型 TRUE の場合、Windows 更新プログラムドライバーは除外されます。 FALSE の場合、Windows Update ドライバーは除外されません。 既定で返されます。 クエリ パラメーターはサポートされていません。
installationSchedule windowsUpdateInstallScheduleType インストール スケジュール。 指定できる値は、ActiveHoursStart、ActiveHoursEnd、ScheduledInstallDay、ScheduledInstallTime です。 既定で返されます。 クエリ パラメーターはサポートされていません。
qualityUpdatesDeferralPeriodInDays Int32 有効な範囲が 0 日から 30 日の場合、品質Updatesをこれらの日数で延期します。 既定で返されます。 クエリ パラメーターはサポートされていません。
featureUpdatesDeferralPeriodInDays Int32 有効な範囲が 0 日から 30 日である、これらの日数で機能のUpdatesを延期します。 既定で返されます。 クエリ パラメーターはサポートされていません。
qualityUpdatesPaused ブール型 TRUE の場合、割り当てられたデバイスは、リングを一時停止した時点から最大 35 日間、品質更新プログラムの受信を一時停止します。 FALSE の場合、品質Updatesは一時停止されません。 既定で返されます。 クエリ パラメーターはサポートされていません。
featureUpdatesPaused ブール型 TRUE の場合、割り当てられたデバイスは、リングを一時停止した時点から最大 35 日間、機能更新プログラムの受信を一時停止します。 FALSE の場合、機能Updatesを一時停止しません。 既定で返されます。 クエリ パラメーターはサポートされていません。s
qualityUpdatesPauseExpiryDateTime DateTimeOffset [品質] Updates [有効期限の一時停止] datetime。 この値は、管理者がリングの一時停止を一時停止または延長してから 35 日です。 既定で返されます。 クエリ パラメーターはサポートされていません。
featureUpdatesPauseExpiryDateTime DateTimeOffset 機能Updates有効期限の datetime を一時停止します。 この値は、管理者がリングの一時停止を一時停止または延長してから 35 日です。 既定で返されます。 クエリ パラメーターはサポートされていません。
businessReadyUpdatesOnly windowsUpdateType 更新プログラムを受け取るブランチ デバイスを決定します。 指定できる値は、UserDefined、All、BusinessReadyOnly、WindowsInsiderBuildFast、WindowsInsiderBuildSlow、WindowsInsiderBuildRelease です。 既定で返されます。 クエリ パラメーターはサポートされていません。 使用可能な値: userDefinedallbusinessReadyOnlywindowsInsiderBuildFastwindowsInsiderBuildSlowwindowsInsiderBuildRelease
skipChecksBeforeRestart ブール型 TRUE の場合、再起動前にすべてのチェックがスキップされます。バッテリー レベル = 40%、ユーザー プレゼンス、ディスプレイが必要、プレゼンテーション モード、全画面表示モード、電話の状態、ゲーム モードなど。FALSE の場合、再起動前にすべてのチェックをスキップしません。 既定で返されます。 クエリ パラメーターはサポートされていません。
updateWeeks windowsUpdateForBusinessUpdateWeeks 月の週に更新プログラムのインストールをスケジュールします。 指定できる値は、UserDefined、FirstWeek、SecondWeek、ThirdWeek、FourthWeek、EveryWeek です。 既定で返されます。 クエリ パラメーターはサポートされていません。 可能な値は、userDefinedfirstWeeksecondWeekthirdWeekfourthWeekeveryWeekunknownFutureValue です。
qualityUpdatesPauseStartDate Date [品質] Updates [一時停止] 開始日。 この値は、管理者がリングの一時停止を一時停止または延長した時刻です。 既定で返されます。 クエリ パラメーターはサポートされていません。 このプロパティは読み取り専用です。
featureUpdatesPauseStartDate Date [機能] Updates [一時停止] 開始日。 この値は、管理者がリングの一時停止を一時停止または延長した時刻です。 既定で返されます。 クエリ パラメーターはサポートされていません。 このプロパティは読み取り専用です。
featureUpdatesRollbackWindowInDays Int32 ロールバックが有効で、有効な範囲が 2 日から 60 日である機能更新プログラムの日数。 既定で返されます。 クエリ パラメーターはサポートされていません。
qualityUpdatesWillBeRolledBack ブール型 TRUE の場合は、次のデバイスチェックで品質Updatesをロールバックします。 FALSE の場合は、次のデバイスチェックで品質Updatesをロールバックしないでください。 既定で返されます。 クエリ パラメーターはサポートされていません。
featureUpdatesWillBeRolledBack ブール型 TRUE の場合は、次のデバイスチェックで機能Updatesをロールバックします。 FALSE の場合は、次のデバイスチェックで機能Updatesをロールバックしないでください。 既定で返されます。クエリ パラメーターはサポートされていません。
qualityUpdatesRollbackStartDateTime DateTimeOffset 品質Updatesロールバックの開始日時。 この値は、管理者がリングの品質更新プログラムをロールバックした時刻です。 既定で返されます。 クエリ パラメーターはサポートされていません。
featureUpdatesRollbackStartDateTime DateTimeOffset 機能Updatesロールバックの開始日時。この値は、管理者がリングの機能更新プログラムをロールバックした時刻です。既定で返されます。クエリ パラメーターはサポートされていません。
engagedRestartDeadlineInDays Int32 有効な 2 日から 30 日の範囲で、アクティブな時間外に保留中の再起動を自動的にスケジュールして実行する前の期限 (日数)。 既定で返されます。 クエリ パラメーターはサポートされていません。
engagedRestartSnoozeScheduleInDays Int32 ユーザーが 1 日から 3 日間の有効な範囲で、エンゲージメント再起動リマインダー通知をスヌーズできる日数。 既定で返されます。 クエリ パラメーターはサポートされていません。
engagedRestartTransitionScheduleInDays Int32 アクティブ時間外にスケジュールされた自動再起動から、ユーザーがスケジュールを設定する必要がある、有効な範囲を 0 から 30 日に切り替えるまでの日数。 既定で返されます。 クエリ パラメーターはサポートされていません。
deadlineForFeatureUpdatesInDays Int32 有効な範囲が 0 から 30 日の機能更新プログラムが自動的にインストールされるまでの日数。 既定で返されます。 クエリ パラメーターはサポートされていません。
deadlineForQualityUpdatesInDays Int32 有効な範囲が 0 から 30 日の品質更新プログラムが自動的にインストールされるまでの日数。 既定で返されます。 クエリ パラメーターはサポートされていません。
deadlineGracePeriodInDays Int32 0 から 7 日間の有効な範囲で、再起動が自動的に実行されるまでの期限後の日数。 既定で返されます。 クエリ パラメーターはサポートされていません。
postponeRebootUntilAfterDeadline ブール型 TRUE の場合、デバイスはアクティブ時間外に再起動する期限まで待機する必要があります。 FALSE の場合、デバイスはアクティブ時間外に再起動する期限まで待機しないでください。 既定で返されます。 クエリ パラメーターはサポートされていません。
autoRestartNotificationDismissal autoRestartNotificationDismissalMethod 自動再起動が必要な通知を無視する方法を指定します。 指定できる値は、NotConfigured、Automatic、User です。 既定で返されます。 クエリ パラメーターはサポートされていません。 使用可能な値: notConfiguredautomaticuserunknownFutureValue
scheduleRestartWarningInHours Int32 自動再起動警告アラーム通知の期間を指定します。 サポートされる値: 2、4、8、12、または 24 (時間)。 既定で返されます。 クエリ パラメーターはサポートされていません。
scheduleImminentRestartWarningInMinutes Int32 自動再起動の差し迫った警告通知の期間を指定します。 サポートされる値: 15、30、または 60 (分)。 既定で返されます。 クエリ パラメーターはサポートされていません。
userPauseAccess enablement エンド ユーザーのアクセスを有効にしてソフトウェア更新プログラムを一時停止するかどうかを指定します。 使用可能な値は、NotConfigured、Enabled、Disabled です。 既定で返されます。 クエリ パラメーターはサポートされていません。 可能な値は notConfiguredenableddisabled です。
userWindowsUpdateScanAccess enablement スキャン Windows Updateへのユーザーのアクセスを無効にするかどうかを指定します。 使用可能な値は、NotConfigured、Enabled、Disabled です。 既定で返されます。 クエリ パラメーターはサポートされていません。 可能な値は notConfiguredenableddisabled です。
updateNotificationLevel windowsUpdateNotificationDisplayOption ユーザーに表示される通知Windows Update指定します。 使用できる値は、NotConfigured、DefaultNotifications、RestartWarningsOnly、DisableAllNotifications です。 既定で返されます。 クエリ パラメーターはサポートされていません。 可能な値は、notConfigureddefaultNotificationsrestartWarningsOnlydisableAllNotificationsunknownFutureValue です。
allowWindows11Upgrade ブール型 TRUE の場合、対象となるWindows 10デバイスをWindows 11にアップグレードできます。 FALSE の場合は、デバイスが既存のオペレーティング システムにとどまります。 既定で返されます。 クエリ パラメーターはサポートされていません。

応答

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

要求

以下は、要求の例です。

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

{
  "@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "deliveryOptimizationMode": "httpOnly",
  "prereleaseFeatures": "settingsOnly",
  "automaticUpdateMode": "notifyDownload",
  "microsoftUpdateServiceAllowed": true,
  "driversExcluded": true,
  "installationSchedule": {
    "@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
    "scheduledInstallDay": "everyday",
    "scheduledInstallTime": "11:59:31.3170000"
  },
  "qualityUpdatesDeferralPeriodInDays": 2,
  "featureUpdatesDeferralPeriodInDays": 2,
  "qualityUpdatesPaused": true,
  "featureUpdatesPaused": true,
  "qualityUpdatesPauseExpiryDateTime": "2017-01-01T00:00:22.9594683-08:00",
  "featureUpdatesPauseExpiryDateTime": "2016-12-31T23:58:08.068669-08:00",
  "businessReadyUpdatesOnly": "all",
  "skipChecksBeforeRestart": true,
  "updateWeeks": "firstWeek",
  "qualityUpdatesPauseStartDate": "2016-12-31",
  "featureUpdatesPauseStartDate": "2016-12-31",
  "featureUpdatesRollbackWindowInDays": 2,
  "qualityUpdatesWillBeRolledBack": true,
  "featureUpdatesWillBeRolledBack": true,
  "qualityUpdatesRollbackStartDateTime": "2016-12-31T23:57:01.05526-08:00",
  "featureUpdatesRollbackStartDateTime": "2017-01-01T00:03:21.6080517-08:00",
  "engagedRestartDeadlineInDays": 12,
  "engagedRestartSnoozeScheduleInDays": 2,
  "engagedRestartTransitionScheduleInDays": 6,
  "deadlineForFeatureUpdatesInDays": 15,
  "deadlineForQualityUpdatesInDays": 15,
  "deadlineGracePeriodInDays": 9,
  "postponeRebootUntilAfterDeadline": true,
  "autoRestartNotificationDismissal": "automatic",
  "scheduleRestartWarningInHours": 13,
  "scheduleImminentRestartWarningInMinutes": 7,
  "userPauseAccess": "enabled",
  "userWindowsUpdateScanAccess": "enabled",
  "updateNotificationLevel": "defaultNotifications",
  "allowWindows11Upgrade": true
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
  "id": "4928dd6a-dd6a-4928-6add-28496add2849",
  "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,
  "deliveryOptimizationMode": "httpOnly",
  "prereleaseFeatures": "settingsOnly",
  "automaticUpdateMode": "notifyDownload",
  "microsoftUpdateServiceAllowed": true,
  "driversExcluded": true,
  "installationSchedule": {
    "@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
    "scheduledInstallDay": "everyday",
    "scheduledInstallTime": "11:59:31.3170000"
  },
  "qualityUpdatesDeferralPeriodInDays": 2,
  "featureUpdatesDeferralPeriodInDays": 2,
  "qualityUpdatesPaused": true,
  "featureUpdatesPaused": true,
  "qualityUpdatesPauseExpiryDateTime": "2017-01-01T00:00:22.9594683-08:00",
  "featureUpdatesPauseExpiryDateTime": "2016-12-31T23:58:08.068669-08:00",
  "businessReadyUpdatesOnly": "all",
  "skipChecksBeforeRestart": true,
  "updateWeeks": "firstWeek",
  "qualityUpdatesPauseStartDate": "2016-12-31",
  "featureUpdatesPauseStartDate": "2016-12-31",
  "featureUpdatesRollbackWindowInDays": 2,
  "qualityUpdatesWillBeRolledBack": true,
  "featureUpdatesWillBeRolledBack": true,
  "qualityUpdatesRollbackStartDateTime": "2016-12-31T23:57:01.05526-08:00",
  "featureUpdatesRollbackStartDateTime": "2017-01-01T00:03:21.6080517-08:00",
  "engagedRestartDeadlineInDays": 12,
  "engagedRestartSnoozeScheduleInDays": 2,
  "engagedRestartTransitionScheduleInDays": 6,
  "deadlineForFeatureUpdatesInDays": 15,
  "deadlineForQualityUpdatesInDays": 15,
  "deadlineGracePeriodInDays": 9,
  "postponeRebootUntilAfterDeadline": true,
  "autoRestartNotificationDismissal": "automatic",
  "scheduleRestartWarningInHours": 13,
  "scheduleImminentRestartWarningInMinutes": 7,
  "userPauseAccess": "enabled",
  "userWindowsUpdateScanAccess": "enabled",
  "updateNotificationLevel": "defaultNotifications",
  "allowWindows11Upgrade": true
}