create groupPolicyUploadedDefinition
名前空間: microsoft.graph
大事な: Microsoft Graph /beta バージョンの API は変更される可能性があります。実稼働環境での使用はサポートされていません。
注: Intune 用 Microsoft Graph API には、テナントの 有効な Intune ライセンスが必要です。
新しい groupPolicyUploadedDefinition オブジェクトを作成 します。
前提条件
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
POST /deviceManagement/groupPolicyDefinitions
POST /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/category/definitions
POST /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/definitionFile/definitions
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| 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 から継承 |
応答
成功した場合、このメソッドは応答コードと、応答本文の 201 Created groupPolicyUploadedDefinition オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitions
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 201 Created
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"
}
フィードバック
フィードバックの送信と表示