aktualisieren von groupPolicyDefinition
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren sie die Eigenschaften eines groupPolicyDefinition-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter 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
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}
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das groupPolicyDefinition-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von groupPolicyDefinition erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
classType | groupPolicyDefinitionClassType | Gibt den Typ der Gruppen an, auf die die Richtlinie angewendet werden kann. Mögliche Werte sind: user und machine . |
displayName | String | Der lokalisierte Richtlinienname. |
explainText | String | Die lokalisierte Erklärung oder der Hilfetext, der der Richtlinie zugeordnet ist. Der Standardwert ist leer. |
categoryPath | String | Der lokalisierte vollständige Kategoriepfad für die Richtlinie. |
Supportedon | String | Lokalisierte Zeichenfolge, die verwendet wird, um anzugeben, welches Betriebssystem oder welche Anwendungsversion von der Richtlinie betroffen ist. |
policyType | groupPolicyType | Gibt den Typ der Gruppenrichtlinie an. Mögliche Werte sind: admxBacked und admxIngested . |
hasRelatedDefinitions | Boolesch | Gibt an, ob es verwandte Definitionen für diese Definition gibt. |
groupPolicyCategoryId | GUID | Die Kategorie-ID der übergeordneten Kategorie |
minDeviceCspVersion | String | Mindestens erforderliche CSP-Version für die Gerätekonfiguration in dieser Definition |
minUserCspVersion | String | Mindestens erforderliche CSP-Version für die Benutzerkonfiguration in dieser Definition |
Version | String | Festlegen der Definitionsversion |
id | String | Schlüssel der Entität |
lastModifiedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der letzten Änderung der Entität. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK
Antwortcode und ein aktualisiertes groupPolicyDefinition-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
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"
}
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 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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für