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 las API de Intune/beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Comprobar la disponibilidad de una API en la versión v1.0 mediante el selector de versión.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualiza las propiedades de un objeto windows10DeviceFirmwareConfigurationInterface .
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado 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 autenticación y autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto windows10DeviceFirmwareConfigurationInterface .
En la tabla siguiente se muestran las propiedades necesarias para crear la windows10DeviceFirmwareConfigurationInterface.
| 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 entidad. Heredado de deviceConfiguration |
| supportsScopeTags | Booleano | Indica si la configuración del dispositivo subyacente admite o no la asignación de etiquetas de ámbito. No se permite la asignación a la propiedad ScopeTags cuando este valor es falso y las entidades no serán visibles para los usuarios con ámbito. Esto ocurre con las directivas heredadas creadas en Silverlight y se puede resolver eliminando y volviendo a crear 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 |
| changeUefiSettingsPermission | changeUefiSettingsPermission | Define el nivel de permiso concedido a los usuarios para cambiar la configuración de UEFI. Los valores posibles son notConfiguredOnly y none. |
| virtualizationOfCpuAndIO | un solo clic | Define si está habilitada la virtualización de CPU y E/S. Los valores posibles son: notConfigured, enabled y disabled. |
| Cámaras | un solo clic | Define si las cámaras integradas están habilitadas. Los valores posibles son: notConfigured, enabled y disabled. |
| microphonesAndSpeakers | un solo clic | Define si los micrófonos integrados o los altavoces están habilitados. Los valores posibles son: notConfigured, enabled y disabled. |
| Señales de radio | un solo clic | Define si las radios integradas, por ejemplo, WIFI, NFC o Bluetooth, están habilitadas. Los valores posibles son: notConfigured, enabled y disabled. |
| bootFromExternalMedia | un solo clic | Define si un usuario puede arrancar desde medios externos. Los valores posibles son: notConfigured, enabled y disabled. |
| bootFromBuiltInNetworkAdapters | un solo clic | Define si un usuario puede arrancar desde adaptadores de red integrados. Los valores posibles son: notConfigured, enabled y disabled. |
| windowsPlatformBinaryTable | un solo clic | Define si un usuario puede habilitar la tabla binaria de la plataforma Windows. Los valores posibles son: notConfigured, enabled y disabled. |
| simultáneoMultiThreading | un solo clic | Define si un usuario puede habilitar MultiThreading simultáneo. Los valores posibles son: notConfigured, enabled y disabled. |
| cámara frontal | un solo clic | Define si un usuario puede habilitar la cámara frontal. Los valores posibles son: notConfigured, enabled y disabled. |
| rearCamera | un solo clic | Define si un usuario puede habilitar la cámara trasera. Los valores posibles son: notConfigured, enabled y disabled. |
| cámara infrarroja | un solo clic | Define si un usuario puede habilitar la cámara de infrarrojos. Los valores posibles son: notConfigured, enabled y disabled. |
| Micrófono | un solo clic | Define si un usuario puede habilitar el micrófono. Los valores posibles son: notConfigured, enabled y disabled. |
| Bluetooth | un solo clic | Define si un usuario puede habilitar Bluetooth. Los valores posibles son: notConfigured, enabled y disabled. |
| inalámbricoWideAreaNetwork | un solo clic | Define si un usuario puede habilitar la red inalámbrica de área extensa. Los valores posibles son: notConfigured, enabled y disabled. |
| nearFieldCommunication | un solo clic | Define si un usuario puede habilitar Near Field Communication. Los valores posibles son: notConfigured, enabled y disabled. |
| wiFi | un solo clic | Define si un usuario puede habilitar el Wi-Fi. Los valores posibles son: notConfigured, enabled y disabled. |
| usbTypeAPort | un solo clic | Define si un usuario puede habilitar un puerto USB tipo A. Los valores posibles son: notConfigured, enabled y disabled. |
| sdCard | un solo clic | Define si un usuario puede habilitar el puerto de tarjeta SD. Los valores posibles son: notConfigured, enabled y disabled. |
| wakeOnLAN | un solo clic | Define si un usuario puede habilitar Wake on LAN. Los valores posibles son: notConfigured, enabled y disabled. |
| wakeOnPower | un solo clic | Define si un usuario puede habilitar Wake On Power. Los valores posibles son: notConfigured, enabled y disabled. |
Respuesta
Si tiene éxito, este método devuelve un 200 OK código de respuesta y un objeto windows10DeviceFirmwareConfigurationInterface 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: 1754
{
"@odata.type": "#microsoft.graph.windows10DeviceFirmwareConfigurationInterface",
"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,
"changeUefiSettingsPermission": "none",
"virtualizationOfCpuAndIO": "enabled",
"cameras": "enabled",
"microphonesAndSpeakers": "enabled",
"radios": "enabled",
"bootFromExternalMedia": "enabled",
"bootFromBuiltInNetworkAdapters": "enabled",
"windowsPlatformBinaryTable": "enabled",
"simultaneousMultiThreading": "enabled",
"frontCamera": "enabled",
"rearCamera": "enabled",
"infraredCamera": "enabled",
"microphone": "enabled",
"bluetooth": "enabled",
"wirelessWideAreaNetwork": "enabled",
"nearFieldCommunication": "enabled",
"wiFi": "enabled",
"usbTypeAPort": "enabled",
"sdCard": "enabled",
"wakeOnLAN": "enabled",
"wakeOnPower": "enabled"
}
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: 1926
{
"@odata.type": "#microsoft.graph.windows10DeviceFirmwareConfigurationInterface",
"id": "96474363-4363-9647-6343-479663434796",
"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,
"changeUefiSettingsPermission": "none",
"virtualizationOfCpuAndIO": "enabled",
"cameras": "enabled",
"microphonesAndSpeakers": "enabled",
"radios": "enabled",
"bootFromExternalMedia": "enabled",
"bootFromBuiltInNetworkAdapters": "enabled",
"windowsPlatformBinaryTable": "enabled",
"simultaneousMultiThreading": "enabled",
"frontCamera": "enabled",
"rearCamera": "enabled",
"infraredCamera": "enabled",
"microphone": "enabled",
"bluetooth": "enabled",
"wirelessWideAreaNetwork": "enabled",
"nearFieldCommunication": "enabled",
"wiFi": "enabled",
"usbTypeAPort": "enabled",
"sdCard": "enabled",
"wakeOnLAN": "enabled",
"wakeOnPower": "enabled"
}