groupPolicyDefinition の更新

名前空間: microsoft.graph

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

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

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

前提条件

この 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

要求本文

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

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

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

応答

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

例

要求

以下は、要求の例です。

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

{
  "@odata.type": "#microsoft.graph.groupPolicyDefinition",
  "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: 643

{
  "@odata.type": "#microsoft.graph.groupPolicyDefinition",
  "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": "f9607947-7947-f960-4779-60f9477960f9",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00"
}