Erstellen von microsoftTunnelConfiguration

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.

Erstellen Sie ein neues microsoftTunnelConfiguration-Objekt .

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

POST /deviceManagement/microsoftTunnelConfigurations

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 objekt microsoftTunnelConfiguration an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von microsoftTunnelConfiguration erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Der eindeutige Bezeichner für die Konfigurations-ID. Unterstützt: $delete, $update. $Insert, $skip, $top wird nicht unterstützt. Schreibgeschützt.
displayName	Zeichenfolge	Der Anzeigename für die Serverkonfiguration. Diese Eigenschaft ist erforderlich, wenn ein Server erstellt wird.
description	Zeichenfolge	Beschreibung der Konfiguration (optional)
Netzwerk	Zeichenfolge	Das IPv4-Subnetz, das zum Zuweisen der virtuellen Adresse für die Clients verwendet wird
ipv6Network	Zeichenfolge	Das IPv6-Subnetz, das zum Zuweisen der virtuellen Adresse für die Clients verwendet wird
dnsServers	String-Sammlung	Die DNS-Server, die von den Clients verwendet werden
defaultDomainSuffix	Zeichenfolge	Der Anhang der Standarddomäne, der von den Clients verwendet wird
routesEinschließen	String-Sammlung	Die Routen, die vom Server weitergeleitet werden. Diese Eigenschaft wird mit der Option zur Verwendung der neuen Eigenschaft "RouteIncludes" als veraltet gekennzeichnet.
routesExclude	String collection	Teilmengen der Routen, die nicht vom Server weitergeleitet werden. Diese Eigenschaft wird mit der Option zur Verwendung der neuen Eigenschaft "RouteExcludes" als veraltet gekennzeichnet.
routeIncludes	Zeichenfolgenauflistung	Die Routen, die vom Server weitergeleitet werden
routeExcludes	Zeichenfolgenauflistung	Teilmengen der Routen, die nicht vom Server weitergeleitet werden
splitDNS	String-Sammlung	Die Domänen, die mithilfe der bereitgestellten DNS-Server aufgelöst werden
listenPort	Int32	Der Port, über den sowohl TCP als auch UPD auf dem Server lauschen.
advancedSettings	keyValuePair-Sammlung	Zusätzliche Einstellungen, die auf den Server angewendet werden können
lastUpdateDateTime	DateTimeOffset	Zeitpunkt der letzten Aktualisierung der Konfiguration
roleScopeTagIds	String-Sammlung	Liste der Bereichstags für diese Entitätsinstanz
disableUdpConnections	Boolesch	Wenn DisableUdpConnections festgelegt ist, verwenden die Clients und der VPN-Server keine DTLS-Verbindungen zum Übertragen von Daten.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein microsoftTunnelConfiguration-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/microsoftTunnelConfigurations
Content-type: application/json
Content-length: 933

{
  "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration",
  "displayName": "Display Name value",
  "description": "Description value",
  "network": "Network value",
  "ipv6Network": "Ipv6Network value",
  "dnsServers": [
    "Dns Servers value"
  ],
  "defaultDomainSuffix": "Default Domain Suffix value",
  "routesInclude": [
    "Routes Include value"
  ],
  "routesExclude": [
    "Routes Exclude value"
  ],
  "routeIncludes": [
    "Route Includes value"
  ],
  "routeExcludes": [
    "Route Excludes value"
  ],
  "splitDNS": [
    "Split DNS value"
  ],
  "listenPort": 10,
  "advancedSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "disableUdpConnections": true
}

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 201 Created
Content-Type: application/json
Content-Length: 982

{
  "@odata.type": "#microsoft.graph.microsoftTunnelConfiguration",
  "id": "b8bdb469-b469-b8bd-69b4-bdb869b4bdb8",
  "displayName": "Display Name value",
  "description": "Description value",
  "network": "Network value",
  "ipv6Network": "Ipv6Network value",
  "dnsServers": [
    "Dns Servers value"
  ],
  "defaultDomainSuffix": "Default Domain Suffix value",
  "routesInclude": [
    "Routes Include value"
  ],
  "routesExclude": [
    "Routes Exclude value"
  ],
  "routeIncludes": [
    "Route Includes value"
  ],
  "routeExcludes": [
    "Route Excludes value"
  ],
  "splitDNS": [
    "Split DNS value"
  ],
  "listenPort": 10,
  "advancedSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "disableUdpConnections": true
}