GroupPolicySettingMapping erstellen

Namespace: microsoft.graph

Wichtig: Microsoft Graph APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Erstellen Sie ein neues groupPolicySettingMapping-Objekt.

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementConfiguration.ReadWrite.All

HTTP-Anforderung

POST /deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer<token> erforderlich
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des groupPolicySettingMapping-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typ "groupPolicySettingMapping" erstellen.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Noch nicht dokumentiert.
Parentid	String	Übergeordnete ID der Gruppenrichtlinieneinstellung.
childIdList	String-Sammlung	Liste der untergeordneten IDs der Gruppenrichtlinieneinstellung.
settingName	String	Der Name dieser Gruppenrichtlinieneinstellung.
settingValue	Zeichenfolge	Der Wert dieser Gruppenrichtlinieneinstellung.
settingValueType	Zeichenfolge	Der Werttyp dieser Gruppenrichtlinieneinstellung.
settingDisplayName	Zeichenfolge	Der Anzeigename dieser Gruppenrichtlinieneinstellung.
settingDisplayValue	Zeichenfolge	Der Anzeigewert dieser Gruppenrichtlinieneinstellung.
settingDisplayValueType	Zeichenfolge	Der Anzeigewerttyp dieser Gruppenrichtlinieneinstellung.
settingValueDisplayUnits	String	Die Anzeigeeinheiten dieses Gruppenrichtlinieneinstellungswerts
settingCategory	String	Die Kategorie, in der sich die Gruppenrichtlinieneinstellung befindet.
mdmCspName	String	Der CSP-Name, dem diese Gruppenrichtlinieneinstellung zugeordnet ist.
mdmSettingUri	String	Der MDM-CSP-URI, dem diese Gruppenrichtlinieneinstellung zugeordnet ist.
mdmMinimumOSVersion	Int32	Die mindeste Betriebssystemversion, die von dieser MDM-Einstellung unterstützt wird.
settingType	groupPolicySettingType	Der Einstellungstyp (Sicherheit oder Admx) der Gruppenrichtlinie. Mögliche Werte sind: unknown , , , , , , , , policy , , account , , , securityOptions , userRightsAssignment , auditSetting , , windowsFirewallSettings , , appLockerRuleCollection dataSourcesSettings , , devicesSettings driveMapSettings environmentVariables filesSettings folderOptions folders iniFiles , internetOptions localUsersAndGroups networkOptions networkShares ntServices powerOptions printers regionalOptionsSettings registrySettings , scheduledTasks shortcutSettings startMenuSettings .
isMdmSupported	Boolescher Wert	Gibt an, ob die Einstellung von Intune unterstützt wird oder nicht.
mdmSupportedState	mdmSupportedState	Gibt an, ob die Einstellung in Mdm unterstützt wird oder nicht. Mögliche Werte: unknown, supported, unsupported, deprecated
settingScope	groupPolicySettingScope	Der Bereich der Einstellung. Mögliche Werte sind: unknown, device und user.
intuneSettingUriList	String-Sammlung	Die Liste der Intune-Einstellungs-URIs, denen diese Gruppenrichtlinieneinstellung zugeordnet ist
intuneSettingDefinitionId	String	Die Intune-Einstellungsdefinitions-ID
admxSettingDefinitionId	String	Admx-Gruppenrichtlinien-ID

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein groupPolicySettingMapping-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId}/groupPolicySettingMappings
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"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 201 Created
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"
}