windowsUpdateForBusinessConfiguration リソースの種類
名前空間: 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
}