deviceManagementReusablePolicySetting aktualisieren
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.
Dient zum Aktualisieren der Eigenschaften eines deviceManagementReusablePolicySetting-Objekts .
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
PATCH /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer<token> erforderlich |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "deviceManagementReusablePolicySetting" an .
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie deviceManagementReusablePolicySetting erstellen.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | Zeichenfolge | vom System generierte wiederverwendbare Einstellungs-ID. |
| displayName | String | Wiederverwendbarer Einstellungsanzeigename, der vom Benutzer angegeben wird. |
| description | String | Vom Benutzer bereitgestellte Beschreibung der wiederverwendbaren Einstellung. |
| settingDefinitionId | Zeichenfolge | Einstellungsdefinitions-ID, die dieser wiederverwendbaren Einstellung zugeordnet ist. |
| settingInstance | deviceManagementConfigurationSettingInstance | Wiederverwendbare Einstellungskonfigurationsinstanz |
| createdDateTime | DateTimeOffset | wiederverwendbares Festlegen von Erstellungsdatum und -uhrzeit. Diese Eigenschaft ist schreibgeschützt. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der wiederverwendbaren Einstellung. Diese Eigenschaft ist schreibgeschützt. |
| Version | Int32 | Versionsnummer für wiederverwendbare Einstellung. Gültige Werte 0 bis 2147483647. Diese Eigenschaft ist schreibgeschützt. |
| referencingConfigurationPolicyCount | Int32 | Anzahl der Konfigurationsrichtlinien, die auf die aktuelle wiederverwendbare Einstellung verweisen. Gültige Werte 0 bis 2147483647. Diese Eigenschaft ist schreibgeschützt. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes deviceManagementReusablePolicySetting-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}
Content-type: application/json
Content-length: 16328
{
"@odata.type": "#microsoft.graph.deviceManagementReusablePolicySetting",
"displayName": "Display Name value",
"description": "Description value",
"settingDefinitionId": "Setting Definition Id value",
"settingInstance": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": null,
"settingInstanceTemplateReference": null,
"choiceSettingValue": null
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
},
"version": 7,
"referencingConfigurationPolicyCount": 3
}
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: 16500
{
"@odata.type": "#microsoft.graph.deviceManagementReusablePolicySetting",
"id": "7a4f9bd7-9bd7-7a4f-d79b-4f7ad79b4f7a",
"displayName": "Display Name value",
"description": "Description value",
"settingDefinitionId": "Setting Definition Id value",
"settingInstance": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": null,
"settingInstanceTemplateReference": null,
"choiceSettingValue": null
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"version": 7,
"referencingConfigurationPolicyCount": 3
}
Feedback
Feedback senden und anzeigen für