windowsUpdateForBusinessConfiguration リソースの種類

[アーティクル]
03/26/2023

名前空間: microsoft.graph

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

ビジネス構成のWindows Updateでは、Windows as a Service が機能と品質の更新プログラムを使用して Windows 10/11 デバイスを更新する方法とタイミングを指定できます。 DeviceConfiguration エンティティがサポートする ODATA 句をサポートします。DeviceConfiguration の種類、$top、deviceConfiguration 基本プロパティのみ$select$filter、DeviceConfiguration 基本プロパティのみ$orderby、$skip。クエリパラメーター '$search' はサポートされていません。

deviceConfiguration から継承します

メソッド

メソッド	戻り値の型	説明
windowsUpdateForBusinessConfigurations のリスト	windowsUpdateForBusinessConfiguration コレクション	windowsUpdateForBusinessConfiguration オブジェクトのプロパティとリレーションシップをリストします。
windowsUpdateForBusinessConfiguration の取得	windowsUpdateForBusinessConfiguration	windowsUpdateForBusinessConfiguration オブジェクトのプロパティとリレーションシップを読み取ります。
windowsUpdateForBusinessConfiguration の作成	windowsUpdateForBusinessConfiguration	新しい windowsUpdateForBusinessConfiguration オブジェクトを作成します。
windowsUpdateForBusinessConfiguration の削除	なし	windowsUpdateForBusinessConfiguration を削除します。
windowsUpdateForBusinessConfiguration の更新	windowsUpdateForBusinessConfiguration	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 を使用すると、ユーザーが設定できます。既定で返されます。クエリパラメーターはサポートされていません。可能な値は、`userDefined`、`httpOnly`、`httpWithPeeringNat`、`httpWithPeeringPrivateGroup`、`httpWithInternetPeering`、`simpleDownload`、`bypassMode` です。
prereleaseFeatures	prereleaseFeatures	プレリリース機能。使用可能な値は、UserDefined、SettingsOnly、SettingsAndExperimentations、NotAllowed です。 UserDefined は既定値であり、意図はありません。既定で返されます。クエリパラメーターはサポートされていません。使用可能な値: `userDefined`、`settingsOnly`、`settingsAndExperimentations`、`notAllowed`。
automaticUpdateMode	automaticUpdateMode	自動更新モード。指定できる値は、UserDefined、NotifyDownload、AutoInstallAtMaintenanceTime、AutoInstallAndRebootAtMaintenanceTime、AutoInstallAndRebootAtScheduledTime、AutoInstallAndRebootWithoutEndUserControl、WindowsDefault です。 UserDefined は既定値であり、意図はありません。既定で返されます。クエリパラメーターはサポートされていません。使用可能な値: `userDefined`、`notifyDownload`、`autoInstallAtMaintenanceTime`、`autoInstallAndRebootAtMaintenanceTime`、`autoInstallAndRebootAtScheduledTime`、`autoInstallAndRebootWithoutEndUserControl`。
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 です。既定で返されます。クエリパラメーターはサポートされていません。使用可能な値: `userDefined`、`all`、`businessReadyOnly`、`windowsInsiderBuildFast`、`windowsInsiderBuildSlow`、`windowsInsiderBuildRelease`。
skipChecksBeforeRestart	ブール型	TRUE の場合、再起動前にすべてのチェックがスキップされます。バッテリーレベル = 40%、ユーザープレゼンス、ディスプレイが必要、プレゼンテーションモード、全画面表示モード、電話の状態、ゲームモードなど。FALSE の場合、再起動前にすべてのチェックをスキップしません。既定で返されます。クエリパラメーターはサポートされていません。
updateWeeks	windowsUpdateForBusinessUpdateWeeks	月の週に更新プログラムのインストールをスケジュールします。指定できる値は、UserDefined、FirstWeek、SecondWeek、ThirdWeek、FourthWeek、EveryWeek です。既定で返されます。クエリパラメーターはサポートされていません。可能な値は、`userDefined`、`firstWeek`、`secondWeek`、`thirdWeek`、`fourthWeek`、`everyWeek`、`unknownFutureValue` です。
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 です。既定で返されます。クエリパラメーターはサポートされていません。使用可能な値: `notConfigured`、`automatic`、`user`、`unknownFutureValue`。
scheduleRestartWarningInHours	Int32	自動再起動警告アラーム通知の期間を指定します。サポートされる値: 2、4、8、12、または 24 (時間)。既定で返されます。クエリパラメーターはサポートされていません。
scheduleImminentRestartWarningInMinutes	Int32	自動再起動の差し迫った警告通知の期間を指定します。サポートされる値: 15、30、または 60 (分)。既定で返されます。クエリパラメーターはサポートされていません。
userPauseAccess	enablement	エンドユーザーのアクセスを有効にしてソフトウェア更新プログラムを一時停止するかどうかを指定します。使用可能な値は、NotConfigured、Enabled、Disabled です。既定で返されます。クエリパラメーターはサポートされていません。可能な値は `notConfigured`、`enabled`、`disabled` です。
userWindowsUpdateScanAccess	enablement	スキャン Windows Updateへのユーザーのアクセスを無効にするかどうかを指定します。使用可能な値は、NotConfigured、Enabled、Disabled です。既定で返されます。クエリパラメーターはサポートされていません。可能な値は `notConfigured`、`enabled`、`disabled` です。
updateNotificationLevel	windowsUpdateNotificationDisplayOption	ユーザーに表示される通知Windows Update指定します。使用できる値は、NotConfigured、DefaultNotifications、RestartWarningsOnly、DisableAllNotifications です。既定で返されます。クエリパラメーターはサポートされていません。可能な値は、`notConfigured`、`defaultNotifications`、`restartWarningsOnly`、`disableAllNotifications`、`unknownFutureValue` です。
allowWindows11Upgrade	ブール型	TRUE の場合、対象となるWindows 10デバイスをWindows 11にアップグレードできます。 FALSE の場合は、デバイスが既存のオペレーティングシステムにとどまります。既定で返されます。クエリパラメーターはサポートされていません。

リレーションシップ

リレーションシップ	型	説明
assignments	deviceConfigurationAssignment コレクション	デバイスの構成プロファイルの割り当てのリスト。 deviceConfiguration から継承します
deviceStatuses	deviceConfigurationDeviceStatus コレクション	デバイスごとのデバイス構成のインストール状況。 deviceConfiguration から継承します
userStatuses	deviceConfigurationUserStatus コレクション	ユーザー別のデバイス構成のインストール状態。 deviceConfiguration から継承します
deviceStatusOverview	deviceConfigurationDeviceOverview	デバイス構成のデバイス状態の概要 (deviceConfiguration から継承)
userStatusOverview	deviceConfigurationUserOverview	デバイス構成のユーザー状態の概要 (deviceConfiguration から継承)
deviceSettingStateSummaries	settingStateDeviceSummary コレクション	デバイス構成設定状態のデバイスの要約 (deviceConfiguration から継承)

JSON 表記

以下は、リソースの JSON 表記です。

{
  "@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "version": 1024,
  "deliveryOptimizationMode": "String",
  "prereleaseFeatures": "String",
  "automaticUpdateMode": "String",
  "microsoftUpdateServiceAllowed": true,
  "driversExcluded": true,
  "installationSchedule": {
    "@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
    "scheduledInstallDay": "String",
    "scheduledInstallTime": "String (time of day)"
  },
  "qualityUpdatesDeferralPeriodInDays": 1024,
  "featureUpdatesDeferralPeriodInDays": 1024,
  "qualityUpdatesPaused": true,
  "featureUpdatesPaused": true,
  "qualityUpdatesPauseExpiryDateTime": "String (timestamp)",
  "featureUpdatesPauseExpiryDateTime": "String (timestamp)",
  "businessReadyUpdatesOnly": "String",
  "skipChecksBeforeRestart": true,
  "updateWeeks": "String",
  "qualityUpdatesPauseStartDate": "String (Date)",
  "featureUpdatesPauseStartDate": "String (Date)",
  "featureUpdatesRollbackWindowInDays": 1024,
  "qualityUpdatesWillBeRolledBack": true,
  "featureUpdatesWillBeRolledBack": true,
  "qualityUpdatesRollbackStartDateTime": "String (timestamp)",
  "featureUpdatesRollbackStartDateTime": "String (timestamp)",
  "engagedRestartDeadlineInDays": 1024,
  "engagedRestartSnoozeScheduleInDays": 1024,
  "engagedRestartTransitionScheduleInDays": 1024,
  "deadlineForFeatureUpdatesInDays": 1024,
  "deadlineForQualityUpdatesInDays": 1024,
  "deadlineGracePeriodInDays": 1024,
  "postponeRebootUntilAfterDeadline": true,
  "autoRestartNotificationDismissal": "String",
  "scheduleRestartWarningInHours": 1024,
  "scheduleImminentRestartWarningInMinutes": 1024,
  "userPauseAccess": "String",
  "userWindowsUpdateScanAccess": "String",
  "updateNotificationLevel": "String",
  "allowWindows11Upgrade": true
}