Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante: Microsoft admite Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Cree un nuevo objeto windowsWifiEnterpriseEAPConfiguration .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto windowsWifiEnterpriseEAPConfiguration.
En la tabla siguiente se muestran las propiedades necesarias al crear windowsWifiEnterpriseEAPConfiguration.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. Heredado de deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceConfiguration |
| roleScopeTagIds | Colección string | Lista de etiquetas de ámbito para esta instancia de entity. Heredado de deviceConfiguration |
| supportsScopeTags | Booleano | Indica si la configuración de dispositivo subyacente admite o no la asignación de etiquetas de ámbito. No se permite asignar a la propiedad ScopeTags cuando este valor es false y las entidades no serán visibles para los usuarios con ámbito. Esto ocurre para las directivas heredadas creadas en Silverlight y se pueden resolver mediante la eliminación y la recreación de la directiva en el portal de Azure. Esta propiedad es de sólo lectura. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Aplicabilidad de la edición del sistema operativo para esta directiva. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Regla de aplicabilidad de la versión del sistema operativo para esta directiva. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Regla de aplicabilidad del modo de dispositivo para esta directiva. Heredado de deviceConfiguration |
| createdDateTime | DateTimeOffset | Fecha y hora en la que se creó el objeto. Heredado de deviceConfiguration |
| description | Cadena | Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration |
| displayName | Cadena | Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration |
| version | Int32 | Versión de la configuración del dispositivo. Heredado de deviceConfiguration |
| wifiSecurityType | wiFiSecurityType | Especifique el tipo de seguridad Wifi. Se hereda de windowsWifiConfiguration. Los valores posibles son: open, wpaPersonal, wpaEnterprise, wep, wpa2Personal, wpa2Enterprise. |
| meteredConnectionLimit | meteredConnectionLimitType | Especifique el tipo de límite de conexión medido para la conexión wifi. Se hereda de windowsWifiConfiguration. Los valores posibles son: unrestricted, fixed y variable. |
| ssid | Cadena | Especifique el SSID de la conexión wifi. Heredado de windowsWifiConfiguration |
| networkName | Cadena | Especifique el nombre de configuración de red. Heredado de windowsWifiConfiguration |
| connectAutomatically | Booleano | Especifique si la conexión wifi debe conectarse automáticamente cuando esté en el intervalo. Heredado de windowsWifiConfiguration |
| connectToPreferredNetwork | Booleano | Especifique si la conexión wifi debe conectarse a más redes preferidas cuando ya esté conectada a esta. Requiere que ConnectAutomatically sea true. Heredado de windowsWifiConfiguration |
| connectWhenNetworkNameIsHidden | Booleano | Especifique si la conexión wifi debe conectarse automáticamente incluso cuando el SSID no esté transmitiendo. Heredado de windowsWifiConfiguration |
| proxySetting | wiFiProxySetting | Especifique la configuración de proxy para Wi-Fi configuración Heredada de windowsWifiConfiguration. Los valores posibles son: none, manual, automatic y unknownFutureValue. |
| proxyManualAddress | Cadena | Especifique la dirección IP del servidor proxy. Heredado de windowsWifiConfiguration |
| proxyManualPort | Int32 | Especifique el puerto del servidor proxy. Heredado de windowsWifiConfiguration |
| proxyAutomaticConfigurationUrl | Cadena | Especifique la dirección URL del script de configuración del servidor proxy. Heredado de windowsWifiConfiguration |
| forceFIPSCompliance | Booleano | Especifique si se va a forzar el cumplimiento de FIPS. Heredado de windowsWifiConfiguration |
| preSharedKey | Cadena | Esta es la clave previamente compartida para wpa personal Wi-Fi red. Heredado de windowsWifiConfiguration |
| networkSingleSignOn | networkSingleSignOnType | Especifique el tipo de inicio de sesión único de red. Los valores posibles son: disabled, prelogon y postlogon. |
| maximumAuthenticationTimeoutInSeconds | Int32 | Especifique el tiempo de espera máximo de autenticación (en segundos). Intervalo válido: 1-120 |
| userBasedVirtualLan | Booleano | Especifique si desea cambiar la LAN virtual que usa el dispositivo en función de las credenciales del usuario. No se puede usar cuando NetworkSingleSignOnType está establecido en Deshabilitado. |
| promptForAdditionalAuthenticationCredentials | Booleano | Especifique si la conexión wifi debe solicitar credenciales de autenticación adicionales. |
| enablePairwiseMasterKeyCaching | Booleano | Especifique si la conexión wifi debe habilitar el almacenamiento en caché de claves maestras en pares. |
| maximumPairwiseMasterKeyCacheTimeInMinutes | Int32 | Especifique el tiempo máximo de caché de clave maestra emparejada (en minutos). Intervalo válido: 5-1440 |
| maximumNumberOfPairwiseMasterKeysInCache | Int32 | Especifique el número máximo de claves maestras en pares en la memoria caché. Intervalo válido: 1-255 |
| enablePreAuthentication | Booleano | Especifique si se debe habilitar la autenticación previa. |
| maximumPreAuthenticationAttempts | Int32 | Especifique el número máximo de intentos de autenticación previa. Intervalo válido: 1-16 |
| eapType | eapType | Protocolo de autenticación extensible (EAP). Indica el tipo de protocolo EAP establecido en el punto de conexión Wi-Fi (enrutador). Valores posibles: eapTls, leap, eapSim, eapTtls, peap, eapFast, teap. |
| trustedServerCertificateNames | Colección string | Especifique nombres de certificado de servidor de confianza. |
| authenticationMethod | wiFiAuthenticationMethod | Especifique el método de autenticación. Los valores posibles son: certificate, usernameAndPassword y derivedCredential. |
| innerAuthenticationProtocolForEAPTTLS | nonEapAuthenticationMethodForEapTtlsType | Especifique el protocolo de autenticación interno para EAP TTLS. Los valores posibles son: unencryptedPassword, challengeHandshakeAuthenticationProtocol, microsoftChap y microsoftChapVersionTwo. |
| outerIdentityPrivacyTemporaryValue | Cadena | Especifique la cadena para reemplazar los nombres de usuario por privacidad al usar EAP TTLS o PEAP. |
| requireCryptographicBinding | Booleano | Especifique si se va a habilitar el enlace criptográfico cuando se selecciona el tipo EAP como PEAP. |
| performServerValidation | Booleano | Especifique si desea habilitar la comprobación de la identidad del servidor mediante la validación del certificado cuando se selecciona el tipo EAP como PEAP. |
| disableUserPromptForServerValidation | Booleano | Especifique si se va a impedir que se pida al usuario que autorice nuevos servidores para entidades de certificación de confianza cuando se selecciona el tipo EAP como PEAP. |
| authenticationPeriodInSeconds | Int32 | Especifique el número de segundos para que el cliente espere después de un intento de autenticación antes de que se produzca un error. Intervalo válido 1-3600. |
| authenticationRetryDelayPeriodInSeconds | Int32 | Especifique el número de segundos entre una autenticación con errores y el siguiente intento de autenticación. Intervalo válido 1-3600. |
| eapolStartPeriodInSeconds | Int32 | Especifique el número de segundos que debe esperar antes de enviar un mensaje de inicio de EAPOL (Protocolo de autenticación extensible a través de LAN). Intervalo válido 1-3600. |
| maximumEAPOLStartMessages | Int32 | Especifique el número máximo de mensajes eapol (protocolo de autenticación extensible sobre LAN) que se van a enviar antes de devolver el error. Intervalo válido de 1 a 100. |
| maximumAuthenticationFailures | Int32 | Especifique el número máximo de errores de autenticación permitidos para un conjunto de credenciales. Intervalo válido de 1 a 100. |
| cacheCredentials | Booleano | Especifique si desea almacenar en caché las credenciales de usuario en el dispositivo para que los usuarios no tengan que seguir especificándolas cada vez que se conecten. |
| authenticationType | wifiAuthenticationType | Especifique si desea autenticar al usuario, el dispositivo o usar la autenticación de invitado (ninguno). Si usa la autenticación de certificado, asegúrese de que el tipo de certificado coincide con el tipo de autenticación. Los valores posibles son: none, user, machine, machineOrUser y guest. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto windowsWifiEnterpriseEAPConfiguration en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 2695
{
"@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
"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,
"wifiSecurityType": "wpaPersonal",
"meteredConnectionLimit": "fixed",
"ssid": "Ssid value",
"networkName": "Network Name value",
"connectAutomatically": true,
"connectToPreferredNetwork": true,
"connectWhenNetworkNameIsHidden": true,
"proxySetting": "manual",
"proxyManualAddress": "Proxy Manual Address value",
"proxyManualPort": 15,
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
"forceFIPSCompliance": true,
"preSharedKey": "Pre Shared Key value",
"networkSingleSignOn": "prelogon",
"maximumAuthenticationTimeoutInSeconds": 5,
"userBasedVirtualLan": true,
"promptForAdditionalAuthenticationCredentials": true,
"enablePairwiseMasterKeyCaching": true,
"maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
"maximumNumberOfPairwiseMasterKeysInCache": 8,
"enablePreAuthentication": true,
"maximumPreAuthenticationAttempts": 0,
"eapType": "leap",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
"outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
"requireCryptographicBinding": true,
"performServerValidation": true,
"disableUserPromptForServerValidation": true,
"authenticationPeriodInSeconds": 13,
"authenticationRetryDelayPeriodInSeconds": 7,
"eapolStartPeriodInSeconds": 9,
"maximumEAPOLStartMessages": 9,
"maximumAuthenticationFailures": 13,
"cacheCredentials": true,
"authenticationType": "user"
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 2867
{
"@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
"id": "7e7183ac-83ac-7e71-ac83-717eac83717e",
"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,
"wifiSecurityType": "wpaPersonal",
"meteredConnectionLimit": "fixed",
"ssid": "Ssid value",
"networkName": "Network Name value",
"connectAutomatically": true,
"connectToPreferredNetwork": true,
"connectWhenNetworkNameIsHidden": true,
"proxySetting": "manual",
"proxyManualAddress": "Proxy Manual Address value",
"proxyManualPort": 15,
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
"forceFIPSCompliance": true,
"preSharedKey": "Pre Shared Key value",
"networkSingleSignOn": "prelogon",
"maximumAuthenticationTimeoutInSeconds": 5,
"userBasedVirtualLan": true,
"promptForAdditionalAuthenticationCredentials": true,
"enablePairwiseMasterKeyCaching": true,
"maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
"maximumNumberOfPairwiseMasterKeysInCache": 8,
"enablePreAuthentication": true,
"maximumPreAuthenticationAttempts": 0,
"eapType": "leap",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
"outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
"requireCryptographicBinding": true,
"performServerValidation": true,
"disableUserPromptForServerValidation": true,
"authenticationPeriodInSeconds": 13,
"authenticationRetryDelayPeriodInSeconds": 7,
"eapolStartPeriodInSeconds": 9,
"maximumEAPOLStartMessages": 9,
"maximumAuthenticationFailures": 13,
"cacheCredentials": true,
"authenticationType": "user"
}