Feedback Bearbeiten

deviceManagementConfigurationRedirectSettingDefinition aktualisieren

  • Artikel
  • 3 Minuten Lesedauer

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 deviceManagementConfigurationRedirectSettingDefinition-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/reusableSettings/{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
Annehmen application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "deviceManagementConfigurationRedirectSettingDefinition " an.

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

Eigenschaft Typ Beschreibung
Anwendbarkeit deviceManagementConfigurationSettingApplicability Details, welche Geräteeinstellung auf "Geerbt von deviceManagementConfigurationSettingDefinition" anwendbar ist
accessTypes deviceManagementConfigurationSettingAccessTypes Lese-/Schreibzugriffsmodus der Einstellung Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte: none, add, copy, delete, get, replace, execute.
"keywords" Zeichenfolgensammlung Token, die Einstellungen für "Geerbt von deviceManagementConfigurationSettingDefinition" durchsuchen
infoUrls Zeichenfolgenauflistung Liste der Links weitere Informationen zu der Einstellung finden Sie unter Geerbt von deviceManagementConfigurationSettingDefinition
Vorkommen deviceManagementConfigurationSettingOccurrence Gibt an, ob die Einstellung erforderlich ist oder nicht Geerbt von deviceManagementConfigurationSettingDefinition
Baseuri String Base CSP Path Inherited from deviceManagementConfigurationSettingDefinition
offsetUri String Offset CSP Path from Base Inherited from deviceManagementConfigurationSettingDefinition
rootDefinitionId Zeichenfolge Definition der Stammeinstellung, wenn es sich bei der Einstellung um eine untergeordnete Einstellung handelt. Geerbt von deviceManagementConfigurationSettingDefinition
Categoryid String Gibt die Bereichsgruppe an, unter der die Einstellung in einem angegebenen Konfigurationsdienstanbieter (CSP) konfiguriert wird, geerbt von deviceManagementConfigurationSettingDefinition
settingUsage deviceManagementConfigurationSettingUsage Einstellungstyp, z. B. Konfiguration und Compliance Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, configuration und compliance.
uxBehavior deviceManagementConfigurationControlType Festlegen der Steuerelementtypdarstellung in der UX Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane.
visibility deviceManagementConfigurationSettingVisibility Festlegen des Sichtbarkeitsbereichs auf UX Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, settingsCatalog und template.
referredSettingInformationList deviceManagementConfigurationReferredSettingInformation-Sammlung Liste der informationen zu den genannten Einstellungen. Geerbt von deviceManagementConfigurationSettingDefinition
id String Bezeichner für element Geerbt von deviceManagementConfigurationSettingDefinition
description Zeichenfolge Beschreibung des Elements Geerbt von deviceManagementConfigurationSettingDefinition
Helptext Zeichenfolge Hilfetext des Elements Geerbt von deviceManagementConfigurationSettingDefinition
name Zeichenfolge Name des Elements Geerbt von deviceManagementConfigurationSettingDefinition
displayName String Anzeigename des Elements Geerbt von deviceManagementConfigurationSettingDefinition
Version String Elementversion Geerbt von deviceManagementConfigurationSettingDefinition
Deeplink String Ein Deep-Link, der auf den bestimmten Speicherort in der Intune Konsole verweist, über den die Featureunterstützung verwaltet werden muss.
redirectMessage String Eine Meldung, in der erläutert wird, dass der Benutzer durch Klicken auf den Link zu einer unterstützten Seite weitergeleitet wird, um die Einstellungen zu verwalten.
redirectReason Zeichenfolge Gibt den Grund für die Umleitung des Benutzers an einen alternativen Speicherort in der Konsole an. Beispiel: WLAN-Profile werden im Einstellungskatalog nicht unterstützt und müssen mit einer Vorlagenrichtlinie erstellt werden.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes Objekt des Typs "deviceManagementConfigurationRedirectSettingDefinition " 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: 1396

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "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",
  "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",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason 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: 1445

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "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",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "3e6c3eab-3eab-3e6c-ab3e-6c3eab3e6c3e",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason value"
}