groupPolicySettingMapping を更新する

[アーティクル]
04/17/2024

名前空間: microsoft.graph

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

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

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

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	✅

アクセス許可

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

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

HTTP 要求

PATCH /deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings/{groupPolicySettingMappingId}

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。必須です。認証と承認の詳細については、こちらをご覧ください。
承諾	application/json

要求本文

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

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

プロパティ	型	説明
id	String
Parentid	String	グループポリシー設定の親 ID。
childIdList	String collection	グループポリシー設定の子 ID の一覧。
settingName	String	このグループポリシー設定の名前。
settingValue	String	このグループポリシー設定の値。
settingValueType	String	このグループポリシー設定の値の種類。
settingDisplayName	String	このグループポリシー設定の表示名。
settingDisplayValue	String	このグループポリシー設定の表示値。
settingDisplayValueType	String	このグループポリシー設定の表示値の種類。
settingValueDisplayUnits	String	このグループポリシー設定値の表示単位
settingCategory	String	グループポリシー設定のカテゴリ。
mdmCspName	String	このグループポリシー設定がマップされる CSP 名。
mdmSettingUri	String	このグループポリシー設定がマップされる MDM CSP URI。
mdmMinimumOSVersion	Int32	この mdm 設定でサポートされる OS の最小バージョン。
settingType	groupPolicySettingType	グループポリシーの設定の種類 (セキュリティまたは admx)。使用できる値は、、、、`account`、`userRightsAssignmentsecurityOptions`、`auditSetting`、`windowsFirewallSettings`、、`appLockerRuleCollection`、`dataSourcesSettings`、`devicesSettings`、`filesSettingsiniFilesfolderOptionsfoldersnetworkOptionsscheduledTasksregistrySettingsprinterspowerOptionsntServiceslocalUsersAndGroupsdriveMapSettingsenvironmentVariablesregionalOptionsSettingsinternetOptionsnetworkShares`、 `shortcutSettingsstartMenuSettings`です。 `policyunknown`
isMdmSupported	ブール型	設定がIntuneでサポートされているかどうかを示します
mdmSupportedState	mdmSupportedState	Mdm で設定がサポートされているかどうかを示します。使用可能な値: `unknown`、`supported`、`unsupported`、`deprecated`。
settingScope	groupPolicySettingScope	設定のスコープ。可能な値は `unknown`、`device`、`user` です。
intuneSettingUriList	String collection	Intune設定 URI の一覧は、このグループポリシー設定がにマップされます。
intuneSettingDefinitionId	String	Intune設定の定義 ID
admxSettingDefinitionId	String	Admx グループポリシー Id

応答

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

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings/{groupPolicySettingMappingId}
Content-type: application/json
Content-length: 1023

{
  "@odata.type": "#microsoft.graph.groupPolicySettingMapping",
  "parentId": "Parent Id value",
  "childIdList": [
    "Child Id List value"
  ],
  "settingName": "Setting Name value",
  "settingValue": "Setting Value value",
  "settingValueType": "Setting Value Type value",
  "settingDisplayName": "Setting Display Name value",
  "settingDisplayValue": "Setting Display Value value",
  "settingDisplayValueType": "Setting Display Value Type value",
  "settingValueDisplayUnits": "Setting Value Display Units value",
  "settingCategory": "Setting Category value",
  "mdmCspName": "Mdm Csp Name value",
  "mdmSettingUri": "Mdm Setting Uri value",
  "mdmMinimumOSVersion": 3,
  "settingType": "policy",
  "isMdmSupported": true,
  "mdmSupportedState": "supported",
  "settingScope": "device",
  "intuneSettingUriList": [
    "Intune Setting Uri List value"
  ],
  "intuneSettingDefinitionId": "Intune Setting Definition Id value",
  "admxSettingDefinitionId": "Admx Setting Definition Id value"
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.groupPolicySettingMapping",
  "id": "8fa04560-4560-8fa0-6045-a08f6045a08f",
  "parentId": "Parent Id value",
  "childIdList": [
    "Child Id List value"
  ],
  "settingName": "Setting Name value",
  "settingValue": "Setting Value value",
  "settingValueType": "Setting Value Type value",
  "settingDisplayName": "Setting Display Name value",
  "settingDisplayValue": "Setting Display Value value",
  "settingDisplayValueType": "Setting Display Value Type value",
  "settingValueDisplayUnits": "Setting Value Display Units value",
  "settingCategory": "Setting Category value",
  "mdmCspName": "Mdm Csp Name value",
  "mdmSettingUri": "Mdm Setting Uri value",
  "mdmMinimumOSVersion": 3,
  "settingType": "policy",
  "isMdmSupported": true,
  "mdmSupportedState": "supported",
  "settingScope": "device",
  "intuneSettingUriList": [
    "Intune Setting Uri List value"
  ],
  "intuneSettingDefinitionId": "Intune Setting Definition Id value",
  "admxSettingDefinitionId": "Admx Setting Definition Id value"
}