update groupPolicyUploadedDefinition

名前空間: microsoft.graph

大事な： Microsoft Graph /beta バージョンの API は変更される可能性があります。実稼働環境での使用はサポートされていません。

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

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

前提条件

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

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

HTTP 要求

PATCH /deviceManagement/groupPolicyDefinitions/{groupPolicyDefinitionId}
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/definition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/nextVersionDefinition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/previousVersionDefinition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/category/definitions/{groupPolicyDefinitionId}
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/definitionFile/definitions/{groupPolicyDefinitionId}

要求ヘッダー

ヘッダー	値
Authorization	ベアラー <トークン> が必要です。
承諾	application/json

要求本文

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

次の表に 、groupPolicyUploadedDefinitionを作成するときに必要なプロパティを示します。

プロパティ	種類	説明
classType	groupPolicyDefinitionClassType	ポリシーを適用できるグループの種類を識別します。 groupPolicyDefinition から継承されます。 可能な値は、user、machine です。
displayName	String	ローカライズされたポリシー名。 groupPolicyDefinition から継承
explainText	String	ポリシーに関連付けられたローカライズされた説明またはヘルプ テキスト。 既定値は空白です。 groupPolicyDefinition から継承
categoryPath	String	ポリシーのローカライズされた完全なカテゴリ パス。 groupPolicyDefinition から継承
supportedOn	String	ポリシーの影響を受けるオペレーティング システムまたはアプリケーションのバージョンを指定するために使用されるローカライズされた文字列。 groupPolicyDefinition から継承
policyType	groupPolicyType	グループ ポリシーの種類を指定します。 groupPolicyDefinition から継承されます。 可能な値は、admxBacked、admxIngested です。
hasRelatedDefinitions	ブール型	この定義に関連する定義が存在するかどうかを示しますgroupPolicyDefinitionから継承
groupPolicyCategoryId	Guid	groupPolicyDefinitionから継承された親カテゴリのカテゴリ ID
minDeviceCspVersion	String	この定義のデバイス構成に必要な最小 CSP バージョン groupPolicyDefinition から継承
minUserCspVersion	String	この定義のユーザー構成に必要な最小 CSP バージョン groupPolicyDefinition から継承
version	String	定義バージョンの設定groupPolicyDefinitionから継承
id	String	エンティティのキー。 groupPolicyDefinition から継承
lastModifiedDateTime	DateTimeOffset	エンティティが最後に変更された日時。 groupPolicyDefinition から継承

応答

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

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitions/{groupPolicyDefinitionId}
Content-type: application/json
Content-length: 538

{
  "@odata.type": "#microsoft.graph.groupPolicyUploadedDefinition",
  "classType": "machine",
  "displayName": "Display Name value",
  "explainText": "Explain Text value",
  "categoryPath": "Category Path value",
  "supportedOn": "Supported On value",
  "policyType": "admxIngested",
  "hasRelatedDefinitions": true,
  "groupPolicyCategoryId": "4d1e97a2-97a2-4d1e-a297-1e4da2971e4d",
  "minDeviceCspVersion": "Min Device Csp Version value",
  "minUserCspVersion": "Min User Csp Version value",
  "version": "Version value"
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.groupPolicyUploadedDefinition",
  "classType": "machine",
  "displayName": "Display Name value",
  "explainText": "Explain Text value",
  "categoryPath": "Category Path value",
  "supportedOn": "Supported On value",
  "policyType": "admxIngested",
  "hasRelatedDefinitions": true,
  "groupPolicyCategoryId": "4d1e97a2-97a2-4d1e-a297-1e4da2971e4d",
  "minDeviceCspVersion": "Min Device Csp Version value",
  "minUserCspVersion": "Min User Csp Version value",
  "version": "Version value",
  "id": "a5f83119-3119-a5f8-1931-f8a51931f8a5",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00"
}