Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig: Microsoft unterstützt Intune/beta-APIs, die jedoch häufiger geändert werden. Microsoft empfiehlt, nach Möglichkeit Version 1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version 1.0 mithilfe der Versionsauswahl.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren sie die Eigenschaften eines deviceManagementConfigurationSettingGroupCollectionDefinition-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | 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 |
| Application | DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das DeviceManagementConfigurationSettingGroupCollectionDefinition-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von deviceManagementConfigurationSettingGroupCollectionDefinition erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Anwendbarkeit | deviceManagementConfigurationSettingApplicability | Gibt an, auf welche Geräteeinstellung anwendbar ist. Unterstützt: $filters. Geerbt von deviceManagementConfigurationSettingDefinition |
| accessTypes | deviceManagementConfigurationSettingAccessTypes | Lese-/Schreibzugriffsmodus der Einstellung Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, add, copy, delete, get, replace, execute. |
| "keywords" | String collection | Token, die einstellungen auf geerbt von deviceManagementConfigurationSettingDefinition durchsucht werden sollen |
| infoUrls | String collection | Liste der Links weitere Informationen zur Einstellung finden Sie unter. Geerbt von deviceManagementConfigurationSettingDefinition |
| Ereignis | deviceManagementConfigurationSettingOccurrence | Gibt an, ob die Einstellung erforderlich ist oder nicht von deviceManagementConfigurationSettingDefinition geerbt wird. |
| baseUri | Zeichenfolge | Basis-CSP-Pfad geerbt von deviceManagementConfigurationSettingDefinition |
| offsetUri | Zeichenfolge | Offset-CSP-Pfad von Base geerbt von deviceManagementConfigurationSettingDefinition |
| rootDefinitionId | Zeichenfolge | Definitions-ID der Stammeinstellung, wenn die Einstellung eine untergeordnete Einstellung ist. Geerbt von deviceManagementConfigurationSettingDefinition |
| categoryId | Zeichenfolge | Geben Sie die Kategorie an, unter der sich die Einstellung befindet. Unterstützung $filters. Geerbt von deviceManagementConfigurationSettingDefinition |
| settingUsage | deviceManagementConfigurationSettingUsage | Geben Sie den Einstellungstyp für die Einstellung an. Die möglichen Werte sind: Konfiguration, Compliance, reusableSetting. Für jede Einstellungsverwendung muss ein separater API-Endpunkt aufgerufen werden. Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, configuration, compliance, unknownFutureValue, inventory. |
| uxBehavior | deviceManagementConfigurationControlType | Festlegen der Darstellung des Steuerelementtyps in der Benutzeroberfläche. Die möglichen Werte sind: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte: default, dropdown, , smallTextBoxlargeTextBox, toggle, multiheaderGrid, contextPane, , . unknownFutureValue |
| visibility | deviceManagementConfigurationSettingVisibility | Festlegen des Sichtbarkeitsbereichs auf UX. Die möglichen Werte sind: none, settingsCatalog, template. Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, settingsCatalog, template, unknownFutureValue, inventoryCatalog. |
| riskLevel | deviceManagementConfigurationSettingRiskLevel | Festlegen der Risikostufe. Die möglichen Werte sind: niedrig, mittel, hoch Geerbt von deviceManagementConfigurationSettingDefinition. Die möglichen Werte sind: low, medium, high. |
| referredSettingInformationList | deviceManagementConfigurationReferredSettingInformation-Sammlung | Liste der Referenzeinstellungsinformationen. Geerbt von deviceManagementConfigurationSettingDefinition |
| id | Zeichenfolge | Bezeichner für element Geerbt von deviceManagementConfigurationSettingDefinition |
| description | Zeichenfolge | Beschreibung der Einstellung. Geerbt von deviceManagementConfigurationSettingDefinition |
| helpText | Zeichenfolge | Hilfetext der Einstellung. Geben Sie weitere Details zur Einstellung an. Geerbt von deviceManagementConfigurationSettingDefinition |
| name | Zeichenfolge | Name des Elements, das von deviceManagementConfigurationSettingDefinition geerbt wurde |
| displayName | String | Name der Einstellung Beispiel: Popup zulassen. Geerbt von deviceManagementConfigurationSettingDefinition |
| Version | Zeichenfolge | Elementversion geerbt von deviceManagementConfigurationSettingDefinition |
| childIds | String collection | Abhängige untergeordnete Einstellungen für diese Gruppe von Einstellungen. Geerbt von deviceManagementConfigurationSettingGroupDefinition |
| dependentOn | deviceManagementConfigurationDependentOn-Sammlung | Liste der Abhängigkeiten für die Einstellungsgruppe Geerbt von deviceManagementConfigurationSettingGroupDefinition |
| dependedOnBy | deviceManagementConfigurationSettingDependedOnBy-Sammlung | Liste der untergeordneten Einstellungen, die von dieser Einstellung abhängen, geerbt von deviceManagementConfigurationSettingGroupDefinition |
| maximumCount | Int32 | Maximale Anzahl von Einstellungsgruppen in der Auflistung. Gültige Werte 1 bis 100 |
| minimumCount | Int32 | Mindestanzahl der Einstellungsgruppenanzahl in der Auflistung. Gültige Werte 1 bis 100 |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes objekt deviceManagementConfigurationSettingGroupCollectionDefinition im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
Content-type: application/json
Content-length: 1813
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
"applicability": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
"description": "Description value",
"platform": "android",
"deviceMode": "kiosk",
"technologies": "mdm"
},
"accessTypes": "add",
"keywords": [
"Keywords value"
],
"infoUrls": [
"Info Urls value"
],
"occurrence": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
"minDeviceOccurrence": 3,
"maxDeviceOccurrence": 3
},
"baseUri": "Base Uri value",
"offsetUri": "Offset Uri value",
"rootDefinitionId": "Root Definition Id value",
"categoryId": "Category Id value",
"settingUsage": "configuration",
"uxBehavior": "dropdown",
"visibility": "settingsCatalog",
"riskLevel": "medium",
"referredSettingInformationList": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
"settingDefinitionId": "Setting Definition Id value"
}
],
"description": "Description value",
"helpText": "Help Text value",
"name": "Name value",
"displayName": "Display Name value",
"version": "Version value",
"childIds": [
"Child Ids value"
],
"dependentOn": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
"dependentOn": "Dependent On value",
"parentSettingId": "Parent Setting Id value"
}
],
"dependedOnBy": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
"dependedOnBy": "Depended On By value",
"required": true
}
],
"maximumCount": 12,
"minimumCount": 12
}
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: 1862
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupCollectionDefinition",
"applicability": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
"description": "Description value",
"platform": "android",
"deviceMode": "kiosk",
"technologies": "mdm"
},
"accessTypes": "add",
"keywords": [
"Keywords value"
],
"infoUrls": [
"Info Urls value"
],
"occurrence": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
"minDeviceOccurrence": 3,
"maxDeviceOccurrence": 3
},
"baseUri": "Base Uri value",
"offsetUri": "Offset Uri value",
"rootDefinitionId": "Root Definition Id value",
"categoryId": "Category Id value",
"settingUsage": "configuration",
"uxBehavior": "dropdown",
"visibility": "settingsCatalog",
"riskLevel": "medium",
"referredSettingInformationList": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
"settingDefinitionId": "Setting Definition Id value"
}
],
"id": "739da194-a194-739d-94a1-9d7394a19d73",
"description": "Description value",
"helpText": "Help Text value",
"name": "Name value",
"displayName": "Display Name value",
"version": "Version value",
"childIds": [
"Child Ids value"
],
"dependentOn": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
"dependentOn": "Dependent On value",
"parentSettingId": "Parent Setting Id value"
}
],
"dependedOnBy": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
"dependedOnBy": "Depended On By value",
"required": true
}
],
"maximumCount": 12,
"minimumCount": 12
}