windows10VpnConfiguration resource type

Note: Using the Microsoft Graph APIs to configure Intune controls and policies still requires that the Intune service is correctly licensed by the customer.

By providing the configurations in this profile you can instruct the Windows 10 device (desktop or mobile) to connect to desired VPN endpoint. By specifying the authentication method and security types expected by VPN endpoint you can make the VPN connection seamless for end user.

Inherits from windowsVpnConfiguration

Methods

Method Return Type Description
List windows10VpnConfigurations windows10VpnConfiguration collection List properties and relationships of the windows10VpnConfiguration objects.
Get windows10VpnConfiguration windows10VpnConfiguration Read properties and relationships of the windows10VpnConfiguration object.
Create windows10VpnConfiguration windows10VpnConfiguration Create a new windows10VpnConfiguration object.
Delete windows10VpnConfiguration None Deletes a windows10VpnConfiguration.
Update windows10VpnConfiguration windows10VpnConfiguration Update the properties of a windows10VpnConfiguration object.
List deviceConfigurationGroupAssignments deviceConfigurationGroupAssignment collection Get the deviceConfigurationGroupAssignments from the groupAssignments navigation property.
List deviceConfigurationDeviceStatuses deviceConfigurationDeviceStatus collection Get the deviceConfigurationDeviceStatuses from the deviceStatuses navigation property.
List deviceConfigurationUserStatuses deviceConfigurationUserStatus collection Get the deviceConfigurationUserStatuses from the userStatuses navigation property.
Get deviceConfigurationDeviceOverview deviceConfigurationDeviceOverview Get the deviceConfigurationDeviceOverview from the deviceStatusOverview navigation property.
Get windows10CertificateProfileBase windows10CertificateProfileBase Get the windows10CertificateProfileBase from the identityCertificate navigation property.

Properties

Property Type Description
id String Key of the entity. Inherited from deviceConfiguration
lastModifiedDateTime DateTimeOffset DateTime the object was last modified. Inherited from deviceConfiguration
createdDateTime DateTimeOffset DateTime the object was created. Inherited from deviceConfiguration
description String Admin provided description of the Device Configuration. Inherited from deviceConfiguration
displayName String Admin provided name of the device configuration. Inherited from deviceConfiguration
version Int32 Version of the device configuration. Inherited from deviceConfiguration
connectionName String Connection name displayed to the user. Inherited from windowsVpnConfiguration
servers vpnServer collection List of VPN Servers on the network. Make sure end users can access these network locations. Inherited from windowsVpnConfiguration
customXml Binary Custom XML commands that configures the VPN connection. (UTF8 encoded byte array) Inherited from windowsVpnConfiguration
connectionType String Connection type. Possible values are: pulseSecure, f5EdgeClient, dellSonicWallMobileConnect, checkPointCapsuleVpn, automatic, ikEv2, l2tp, pptp.
enableSplitTunneling Boolean Enable split tunneling.
authenticationMethod String Authentication method. Possible values are: certificate, usernameAndPassword, customEapXml.
rememberUserCredentials Boolean Remember user credentials.
enableConditionalAccess Boolean Enable conditional access.
enableSingleSignOnWithAlternateCertificate Boolean Enable single sign-on (SSO) with alternate certificate.
singleSignOnEku extendedKeyUsage Single sign-on Extended Key Usage (EKU).
singleSignOnIssuerHash String Single sign-on issuer hash.
eapXml Binary Extensible Authentication Protocol (EAP) XML. (UTF8 encoded byte array)
proxyServer windows10VpnProxyServer Proxy Server.
associatedApps windows10AssociatedApps collection Associated Apps.
onlyAssociatedAppsCanUseConnection Boolean Only associated Apps can use connection (per-app VPN).
windowsInformationProtectionDomain String Windows Information Protection (WIP) domain to associate with this connection.
trafficRules vpnTrafficRule collection Traffic rules.
routes vpnRoute collection Routes (optional for third-party providers).
dnsRules vpnDnsRule collection DNS rules.

Relationships

Relationship Type Description
groupAssignments deviceConfigurationGroupAssignment collection The list of group assignments for the device configuration profile. Inherited from deviceConfiguration
deviceStatuses deviceConfigurationDeviceStatus collection Device configuration installation stauts by device. Inherited from deviceConfiguration
userStatuses deviceConfigurationUserStatus collection Device configuration installation stauts by user. Inherited from deviceConfiguration
deviceStatusOverview deviceConfigurationDeviceOverview Device Configuration devices status overview Inherited from deviceConfiguration
identityCertificate windows10CertificateProfileBase Identity certificate for client authentication when authentication method is certificate.

JSON Representation

Here is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.windows10VpnConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "version": 1024,
  "connectionName": "String",
  "servers": [
    {
      "@odata.type": "microsoft.graph.vpnServer",
      "description": "String",
      "ipAddressOrFqdn": "String",
      "isDefaultServer": true
    }
  ],
  "customXml": "binary",
  "connectionType": "String",
  "enableSplitTunneling": true,
  "authenticationMethod": "String",
  "rememberUserCredentials": true,
  "enableConditionalAccess": true,
  "enableSingleSignOnWithAlternateCertificate": true,
  "singleSignOnEku": {
    "@odata.type": "microsoft.graph.extendedKeyUsage",
    "name": "String",
    "objectIdentifier": "String"
  },
  "singleSignOnIssuerHash": "String",
  "eapXml": "binary",
  "proxyServer": {
    "@odata.type": "microsoft.graph.windows10VpnProxyServer",
    "automaticConfigurationScriptUrl": "String",
    "address": "String",
    "port": 1024,
    "bypassProxyServerForLocalAddress": true
  },
  "associatedApps": [
    {
      "@odata.type": "microsoft.graph.windows10AssociatedApps",
      "appType": "String",
      "identifier": "String"
    }
  ],
  "onlyAssociatedAppsCanUseConnection": true,
  "windowsInformationProtectionDomain": "String",
  "trafficRules": [
    {
      "@odata.type": "microsoft.graph.vpnTrafficRule",
      "name": "String",
      "protocols": 1024,
      "localPortRanges": [
        {
          "@odata.type": "microsoft.graph.numberRange",
          "lowerNumber": 1024,
          "upperNumber": 1024
        }
      ],
      "remotePortRanges": [
        {
          "@odata.type": "microsoft.graph.numberRange",
          "lowerNumber": 1024,
          "upperNumber": 1024
        }
      ],
      "localAddressRanges": [
        {
          "@odata.type": "microsoft.graph.iPv4Range",
          "lowerAddress": "String",
          "upperAddress": "String"
        }
      ],
      "remoteAddressRanges": [
        {
          "@odata.type": "microsoft.graph.iPv4Range",
          "lowerAddress": "String",
          "upperAddress": "String"
        }
      ],
      "appId": "String",
      "appType": "String",
      "routingPolicyType": "String",
      "claims": "String"
    }
  ],
  "routes": [
    {
      "@odata.type": "microsoft.graph.vpnRoute",
      "destinationPrefix": "String",
      "prefixSize": 1024
    }
  ],
  "dnsRules": [
    {
      "@odata.type": "microsoft.graph.vpnDnsRule",
      "name": "String",
      "servers": [
        "String"
      ],
      "proxyServerUri": "String"
    }
  ]
}