Creación de windowsWifiEnterpriseEAPConfiguration

Artículo
08/01/2024

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

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 Azure Portal. 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
preSharedKey	Cadena	Esta es la clave previamente compartida para wpa personal Wi-Fi red. Heredado de windowsWifiConfiguration
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
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 de cadenas	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,
  "preSharedKey": "Pre Shared Key value",
  "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,
  "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,
  "preSharedKey": "Pre Shared Key value",
  "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,
  "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"
}

Compartir a través de

Creación de windowsWifiEnterpriseEAPConfiguration

Permisos

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplo

Solicitud

Respuesta

Comentarios

Recursos adicionales