命名空间:microsoft.graph
重要:Microsoft支持Intune /beta API,但它们会受到更频繁的更改。 Microsoft建议尽可能使用版本 v1.0。 使用版本选择器检查 API 在 v1.0 版中的可用性。
注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
更新 macOSWiredNetworkConfiguration 对象的属性。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | DeviceManagementConfiguration.ReadWrite.All |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用程序 | DeviceManagementConfiguration.ReadWrite.All |
HTTP 请求
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
请求标头
| 标头 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| 接受 | application/json |
请求正文
在请求正文中,提供 macOSWiredNetworkConfiguration 对象的 JSON 表示形式。
下表显示了创建 macOSWiredNetworkConfiguration 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| 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 |
| networkName | String | 网络名 |
| networkInterface | wiredNetworkInterface | 网络接口。 可取值包括:anyEthernet、firstActiveEthernet、secondActiveEthernet、thirdActiveEthernet、firstEthernet、secondEthernet、thirdEthernet。 |
| eapType | eapType | 可扩展身份验证协议 (EAP) 。 指示在有线网络上设置的 EAP 协议的类型。 可取值包括:eapTls、leap、eapSim、eapTtls、peap、eapFast、teap。 |
| eapFastConfiguration | eapFastConfiguration | 当 EAP-FAST 是所选 EAP 类型时,EAP-FAST 配置选项。 可能的值包括 noProtectedAccessCredential、useProtectedAccessCredential、useProtectedAccessCredentialAndProvision、useProtectedAccessCredentialAndProvisionAnonymously。 |
| trustedServerCertificateNames | 字符串集合 | 当 EAP 类型配置为 EAP-TLS/TTLS/FAST 或 PEAP 时,受信任的服务器证书名称。 这是受信任的证书颁发机构 (CA) 颁发的证书中使用的公用名称。 如果提供此信息,则可以绕过最终用户连接到此有线网络时显示在设备上的动态信任对话框。 |
| authenticationMethod | wiFiAuthenticationMethod | 将 EAP 类型配置为 PEAP 或 EAP-TTLS 时的身份验证方法。 可能的值包括 certificate、usernameAndPassword、derivedCredential。 |
| nonEapAuthenticationMethodForEapTtls | nonEapAuthenticationMethodForEapTtlsType | 当 EAP 类型为 EAP-TTLS 且身份验证方法为用户名和密码时,用于身份验证的非 EAP 方法 (内部标识) 。 可能的值包括 unencryptedPassword、challengeHandshakeAuthenticationProtocol、microsoftChap、microsoftChapVersionTwo。 |
| enableOuterIdentityPrivacy | String | 将 EAP 类型配置为 EAP-TTLS、EAP-FAST 或 PEAP 时,启用标识隐私 (外部标识) 。 此属性使用输入的文本屏蔽用户名。 例如,如果使用“匿名”,则使用此有线网络进行身份验证的每个用户的真实用户名将显示为“匿名”。 |
| deploymentChannel | appleDeploymentChannel | 指示用于部署配置文件的部署通道类型。 可能的值为 deviceChannel、userChannel。 可能的值包括 deviceChannel、userChannel、unknownFutureValue。 |
响应
如果成功,此方法在响应正文中返回响应 200 OK 代码和更新 的 macOSWiredNetworkConfiguration 对象。
示例
请求
下面是一个请求示例。
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1538
{
"@odata.type": "#microsoft.graph.macOSWiredNetworkConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"networkName": "Network Name value",
"networkInterface": "firstActiveEthernet",
"eapType": "leap",
"eapFastConfiguration": "useProtectedAccessCredential",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
"enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
"deploymentChannel": "userChannel"
}
响应
下面是一个响应示例。 注意:为简洁起见,可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1710
{
"@odata.type": "#microsoft.graph.macOSWiredNetworkConfiguration",
"id": "e5a57519-7519-e5a5-1975-a5e51975a5e5",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"networkName": "Network Name value",
"networkInterface": "firstActiveEthernet",
"eapType": "leap",
"eapFastConfiguration": "useProtectedAccessCredential",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"nonEapAuthenticationMethodForEapTtls": "challengeHandshakeAuthenticationProtocol",
"enableOuterIdentityPrivacy": "Enable Outer Identity Privacy value",
"deploymentChannel": "userChannel"
}