Actualizar windowsWifiEnterpriseEAPConfiguration
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.
Actualice las propiedades de un 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
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
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 de cadenas | 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 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 200 OK
código de respuesta y un objeto windowsWifiEnterpriseEAPConfiguration actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
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 200 OK
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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de