Aktualisieren von deviceManagementConfigurationPolicy
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 deviceManagementConfigurationPolicy-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/configurationPolicies/{deviceManagementConfigurationPolicyId}
PATCH /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}
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 deviceManagementConfigurationPolicy-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen der deviceManagementConfigurationPolicy erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | Zeichenfolge | Schlüssel des Richtliniendokuments. Automatisch generiert. |
name | Zeichenfolge | Richtlinienname |
description | Zeichenfolge | Richtlinienbeschreibung |
Plattformen | deviceManagementConfigurationPlatforms | Plattformen für diese Richtlinie. Mögliche Werte: none , android , iOS , macOS , windows10X , windows10 , linux , unknownFutureValue . |
technologieen | deviceManagementConfigurationTechnologies | Technologien für diese Richtlinie. Mögliche Werte sind: none , mdm , windows10XManagement , configManager , appleRemoteManagement , microsoftSense , , mobileApplicationManagement exchangeOnline , linuxMdm , extensibility enrollment , , endpointPrivilegeManagement , unknownFutureValue , . windowsOsRecovery |
createdDateTime | DateTimeOffset | Datum und Uhrzeit der Richtlinienerstellung |
lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der Richtlinie |
settingCount | Int32 | Anzahl der Einstellungen |
creationSource | Zeichenfolge | Quelle für die Richtlinienerstellung |
roleScopeTagIds | String-Sammlung | Liste der Bereichstags für diese Entitätsinstanz. |
isAssigned | Boolesch | Richtlinienzuweisungsstatus. Diese Eigenschaft ist schreibgeschützt. |
templateReference | deviceManagementConfigurationPolicyTemplateReference | Vorlagenreferenzinformationen |
priorityMetaData | deviceManagementPriorityMetaData | Gibt die Priorität der einzelnen Richtlinien an, die während des Registrierungsprozesses vom Administrator ausgewählt werden. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK
Antwortcode und ein aktualisiertes objekt deviceManagementConfigurationPolicy im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
Content-type: application/json
Content-length: 809
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
"name": "Name value",
"description": "Description value",
"platforms": "android",
"technologies": "mdm",
"settingCount": 12,
"creationSource": "Creation Source value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"isAssigned": true,
"templateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyTemplateReference",
"templateId": "Template Id value",
"templateFamily": "endpointSecurityAntivirus",
"templateDisplayName": "Template Display Name value",
"templateDisplayVersion": "Template Display Version value"
},
"priorityMetaData": {
"@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
"priority": 8
}
}
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: 981
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
"id": "3ffd7cd0-7cd0-3ffd-d07c-fd3fd07cfd3f",
"name": "Name value",
"description": "Description value",
"platforms": "android",
"technologies": "mdm",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"settingCount": 12,
"creationSource": "Creation Source value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"isAssigned": true,
"templateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationPolicyTemplateReference",
"templateId": "Template Id value",
"templateFamily": "endpointSecurityAntivirus",
"templateDisplayName": "Template Display Name value",
"templateDisplayVersion": "Template Display Version value"
},
"priorityMetaData": {
"@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
"priority": 8
}
}