命名空间:microsoft.graph
重要:Microsoft支持Intune /beta API,但它们会受到更频繁的更改。 Microsoft建议尽可能使用版本 v1.0。 使用版本选择器检查 API 在 v1.0 版中的可用性。
注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
通过在此配置文件中提供配置,可以指示 iOS 设备连接到所需的 VPN 终结点。 通过指定 VPN 终结点所需的身份验证方法和安全类型,可以为最终用户实现无缝 VPN 连接。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 列出 iosVpnConfigurations | iosVpnConfiguration 集合 | 列出 iosVpnConfiguration 对象的属性和关系。 |
| 获取 iosVpnConfiguration | iosVpnConfiguration | 读取 iosVpnConfiguration 对象的属性和关系。 |
| 创建 iosVpnConfiguration | iosVpnConfiguration | 创建新的 iosVpnConfiguration 对象。 |
| 删除 iosVpnConfiguration | 无 | 删除 iosVpnConfiguration。 |
| 更新 iosVpnConfiguration | iosVpnConfiguration | 更新 iosVpnConfiguration 对象的属性。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 实体的键。 继承自 deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | 上次修改对象的日期/时间。 继承自 deviceConfiguration |
| roleScopeTagIds | 字符串集合 | 此实体实例的范围标记列表。 继承自 deviceConfiguration |
| supportsScopeTags | 布尔值 | 指示基础设备配置是否支持分配范围标记。 如果此值为 false,并且实体对限定范围的用户不可见,则不允许向 ScopeTags 属性分配。 这种情况发生在 Silverlight 中创建的旧策略中,可以通过在 Azure 门户中删除并重新创建策略来解决。 此属性是只读的。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | 此策略的 OS 版本适用性。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | 此策略的 OS 版本适用性规则。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | 此策略的设备模式适用性规则。 继承自 deviceConfiguration |
| createdDateTime | DateTimeOffset | 创建对象的日期/时间。 继承自 deviceConfiguration |
| description | String | 管理员提供的设备配置的说明。 继承自 deviceConfiguration |
| displayName | String | 管理员提供的设备配置的名称。 继承自 deviceConfiguration |
| version | Int32 | 设备配置的版本。 继承自 deviceConfiguration |
| connectionName | String | 向用户显示的连接名称。 继承自 appleVpnConfiguration |
| connectionType | appleVpnConnectionType | 连接类型。 继承自 appleVpnConfiguration。 可能的值为:ciscoAnyConnect、、f5EdgeClientpulseSecure、customVpnciscoIPSeccitrixciscoAnyConnectV2dellSonicWallMobileConnectcheckPointCapsuleVpnpaloAltoGlobalProtect、paloAltoGlobalProtectV2ikEv2citrixSsozscalerPrivateAccessf5Access2018alwaysOn、microsoftTunnel、netMotionMobility、 。 microsoftProtect |
| loginGroupOrDomain | String | 当连接类型设置为 Dell SonicWALL Mobile Connection 时,登录组或域。 继承自 appleVpnConfiguration |
| role | String | 连接类型设置为 Pulse Secure 时的角色。 继承自 appleVpnConfiguration |
| 领域 | String | 连接类型设置为 Pulse Secure 时的领域。 继承自 appleVpnConfiguration |
| 服务器 | vpnServer | 网络上的 VPN 服务器。 确保最终用户可以访问此网络位置。 继承自 appleVpnConfiguration |
| 标识符 | String | 当连接类型设置为“自定义 VPN”时,VPN 供应商提供的标识符。 例如:Cisco AnyConnect 使用格式为 com.cisco.anyconnect.applevpn.plugin 继承自 appleVpnConfiguration 的标识符 |
| customData | keyValue 集合 | 将连接类型设置为“自定义 VPN”时的自定义数据。 使用此字段启用Intune不支持的功能,但在 VPN 解决方案中可用。 请联系 VPN 供应商,了解如何添加这些键/值对。 此集合最多可以包含 25 个元素。 继承自 appleVpnConfiguration |
| customKeyValueData | keyValuePair 集合 | 将连接类型设置为“自定义 VPN”时的自定义数据。 使用此字段启用Intune不支持的功能,但在 VPN 解决方案中可用。 请联系 VPN 供应商,了解如何添加这些键/值对。 此集合最多可以包含 25 个元素。 继承自 appleVpnConfiguration |
| enableSplitTunneling | 布尔值 | 通过 VPN 发送所有网络流量。 继承自 appleVpnConfiguration |
| authenticationMethod | vpnAuthenticationMethod | 此 VPN 连接的身份验证方法。 继承自 appleVpnConfiguration。 可能的值包括 certificate、usernameAndPassword、sharedSecret、derivedCredential、azureAD。 |
| enablePerApp | 布尔值 | 将其设置为 true 会创建 Per-App VPN 有效负载,该有效负载稍后可与可在最终用户的 iOS 设备上触发此 VPN 连接的应用相关联。 继承自 appleVpnConfiguration |
| safariDomains | 字符串集合 | 启用此 VPN 时启用“按应用”设置的 Safari 域。 除了与此 VPN 关联的应用外,此处指定的 Safari 域还可以触发此 VPN 连接。 继承自 appleVpnConfiguration |
| onDemandRules | vpnOnDemandRule 集合 | 按需规则。 该集合最多可包含 500 个元素。 继承自 appleVpnConfiguration |
| providerType | vpnProviderType | 每应用 VPN 的提供程序类型。 继承自 appleVpnConfiguration。 可能的值包括 notConfigured、appProxy、packetTunnel。 |
| associatedDomains | 字符串集合 | 从 appleVpnConfiguration 继承的关联域 |
| excludedDomains | 字符串集合 | 通过公共 Internet 而不是通过 VPN 访问的域,即使激活了从 appleVpnConfiguration 继承的按应用 VPN 也是如此 |
| disableOnDemandUserOverride | 布尔值 | 切换以防止用户在“设置”应用中禁用自动 VPN,该应用继承自 appleVpnConfiguration |
| disconnectOnIdle | 布尔值 | 是否在按需连接空闲后断开连接 继承自 appleVpnConfiguration |
| disconnectOnIdleTimerInSeconds | Int32 | 断开按需连接之前等待的时间长度(以秒为单位)。 有效值 0 到 65535 继承自 appleVpnConfiguration |
| proxyServer | vpnProxyServer | 代理服务器。 继承自 appleVpnConfiguration |
| optInToDeviceIdSharing | 布尔值 | Opt-In 将设备的 ID 共享给第三方 vpn 客户端,以便在网络访问控制验证期间使用。 继承自 appleVpnConfiguration |
| userDomain | String | 仅限 Zscaler。 输入静态域以在 Zscaler 应用中预填充登录字段。 如果将其留空,则将改用用户的 Azure Active Directory 域。 |
| strictEnforcement | 布尔值 | 仅限 Zscaler。 阻止网络流量,直到用户登录到 Zscaler 应用。 “True”表示流量被阻止。 |
| cloudName | String | 仅限 Zscaler。 用户分配到的 Zscaler 云。 |
| excludeList | 字符串集合 | 仅限 Zscaler。 未通过 Zscaler 云发送的网络地址列表。 |
| targetedMobileApps | appListItem 集合 | 目标移动应用。 该集合最多可包含 500 个元素。 |
| microsoftTunnelSiteId | String | Microsoft Tunnel 站点 ID。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| groupAssignments | deviceConfigurationGroupAssignment 集合 | 设备配置文件的组分配列表。 继承自 deviceConfiguration |
| assignments | deviceConfigurationAssignment 集合 | 设备配置文件的分配列表。 继承自 deviceConfiguration |
| deviceStatuses | deviceConfigurationDeviceStatus 集合 | 按设备的设备配置安装状态。 继承自 deviceConfiguration |
| userStatuses | deviceConfigurationUserStatus 集合 | 按用户排列的设备配置安装状态。 继承自 deviceConfiguration |
| deviceStatusOverview | deviceConfigurationDeviceOverview | 设备配置设备状态概述 继承自 deviceConfiguration |
| userStatusOverview | deviceConfigurationUserOverview | 设备配置用户状态概述 继承自 deviceConfiguration |
| deviceSettingStateSummaries | settingStateDeviceSummary 集合 | 设备配置设置状态设备摘要 继承自 deviceConfiguration |
| identityCertificate | iosCertificateProfileBase | 身份验证方法是证书时用于客户端身份验证的标识证书。 |
| derivedCredentialSettings | deviceManagementDerivedCredentialSettings | 要用于身份验证的派生凭据的租户级别设置。 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.iosVpnConfiguration",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"roleScopeTagIds": [
"String"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"String"
],
"name": "String",
"ruleType": "String"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "String",
"maxOSVersion": "String",
"name": "String",
"ruleType": "String"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "String",
"name": "String",
"ruleType": "String"
},
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"version": 1024,
"connectionName": "String",
"connectionType": "String",
"loginGroupOrDomain": "String",
"role": "String",
"realm": "String",
"server": {
"@odata.type": "microsoft.graph.vpnServer",
"description": "String",
"address": "String",
"isDefaultServer": true
},
"identifier": "String",
"customData": [
{
"@odata.type": "microsoft.graph.keyValue",
"key": "String",
"value": "String"
}
],
"customKeyValueData": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "String",
"value": "String"
}
],
"enableSplitTunneling": true,
"authenticationMethod": "String",
"enablePerApp": true,
"safariDomains": [
"String"
],
"onDemandRules": [
{
"@odata.type": "microsoft.graph.vpnOnDemandRule",
"ssids": [
"String"
],
"dnsSearchDomains": [
"String"
],
"probeUrl": "String",
"action": "String",
"domainAction": "String",
"domains": [
"String"
],
"probeRequiredUrl": "String",
"interfaceTypeMatch": "String",
"dnsServerAddressMatch": [
"String"
]
}
],
"providerType": "String",
"associatedDomains": [
"String"
],
"excludedDomains": [
"String"
],
"disableOnDemandUserOverride": true,
"disconnectOnIdle": true,
"disconnectOnIdleTimerInSeconds": 1024,
"proxyServer": {
"@odata.type": "microsoft.graph.vpnProxyServer",
"automaticConfigurationScriptUrl": "String",
"address": "String",
"port": 1024
},
"optInToDeviceIdSharing": true,
"userDomain": "String",
"strictEnforcement": true,
"cloudName": "String",
"excludeList": [
"String"
],
"targetedMobileApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "String",
"publisher": "String",
"appStoreUrl": "String",
"appId": "String"
}
],
"microsoftTunnelSiteId": "String"
}