hybridAgentUpdaterConfiguration リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

テナント管理者は、エージェントが更新プログラムを受信したり、エージェントの更新を延期したりできるタイム ウィンドウを onPremisesPublishingProfile ごとに構成できます。 onPremisesPublishingProfile に指定された hybridAgentUpdaterConfiguration は、onPremisesPublishingProfile 内のすべてのエージェントに適用できます。

たとえば、onPremisesPublishingProfile 型 "プロビジョニング" のエージェントの場合、手順は以下のようになります。

  1. テナント管理者は、次の n 日間のプロビジョニング エージェントに対する更新プログラムを受け取らなく設定できます。
  2. テナント管理者は、エージェントが更新プログラムを再読み込みできる更新ウィンドウ (開始時刻と終了時刻) を構成できます。
  3. テナント管理者は allowUpdateConfigurationOverride を有効にし、プロビジョニング エージェントのアップデータ構成を上書きし、次に利用可能な更新プログラムを受け取る許可を与えます。

アップデータ構成で指定された DateTime/Time 情報は、evaluvation 中にエージェントによって報告されたローカル タイム ゾーンに変換されます。

エージェントの更新は、以下の優先度リストに従います

  1. allowUpdateConfigurationOverride が true に設定されている場合、テナントによって設定されたアップデータ構成はスキップされ、エージェントの次のバージョンが使用可能なときに更新プログラムが受信されます (優先度 1)。
  2. 延期更新が設定されている場合、更新日時を延期するまでエージェントは更新されません (優先度 2)。
  3. 更新ウィンドウが設定されている場合、エージェントは 24 時間 (優先度 3) のそのタイム ウィンドウの間にのみ更新されます。
  4. テナントによって有効なアップデータ構成が設定されていない場合、エージェントは、次のバージョンのエージェントが使用可能なときに更新プログラムを受信します。

Properties

プロパティ 説明
allowUpdateConfigurationOverride ブール値 更新プログラムの構成がスキップされ、エージェントの次のバージョンが利用可能なときにエージェントが更新プログラムを受信するかどうかを示します。
deferUpdateDateTime DateTimeOffset Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
updateWindow updateWindow

JSON 表記

リソースの JSON 表記を次に示します。

{
  "allowUpdateConfigurationOverride": true,
  "deferUpdateDateTime": "String (timestamp)",
  "updateWindow": {"@odata.type": "microsoft.graph.updateWindow"}
}