Creación de windows10DeviceFirmwareConfigurationInterface
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 windows10DeviceFirmwareConfigurationInterface .
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 windows10DeviceFirmwareConfigurationInterface.
En la tabla siguiente se muestran las propiedades necesarias al crear 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 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 |
| 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 | Habilitación | Define si la virtualización de CPU e E/S está habilitada. Los valores posibles son: notConfigured, enabled y disabled. |
| Cámaras | Habilitación | Define si las cámaras integradas están habilitadas. Los valores posibles son: notConfigured, enabled y disabled. |
| microphonesAndSpeakers | Habilitación | Define si los micrófonos o altavoces integrados están habilitados. Los valores posibles son: notConfigured, enabled y disabled. |
| Radios | Habilitación | Define si las radios integradas, por ejemplo, WIFI, NFC, Bluetooth, están habilitadas. Los valores posibles son: notConfigured, enabled y disabled. |
| bootFromExternalMedia | Habilitación | Define si un usuario puede arrancar desde medios externos. Los valores posibles son: notConfigured, enabled y disabled. |
| bootFromBuiltInNetworkAdapters | Habilitación | Define si un usuario puede arrancar desde adaptadores de red integrados. Los valores posibles son: notConfigured, enabled y disabled. |
| windowsPlatformBinaryTable | Habilitación | Define si un usuario puede habilitar la tabla binaria de la plataforma Windows. Los valores posibles son: notConfigured, enabled y disabled. |
| simultaneousMultiThreading | Habilitación | Define si un usuario puede habilitar multithreading simultáneo. Los valores posibles son: notConfigured, enabled y disabled. |
| frontCamera | Habilitación | Define si un usuario puede habilitar la cámara frontal. Los valores posibles son: notConfigured, enabled y disabled. |
| Rearcamera | Habilitación | Define si un usuario puede habilitar la cámara trasera. Los valores posibles son: notConfigured, enabled y disabled. |
| infraredCamera | Habilitación | Define si un usuario puede habilitar la cámara infrarroja. Los valores posibles son: notConfigured, enabled y disabled. |
| Micrófono | Habilitación | Define si un usuario puede habilitar el micrófono. Los valores posibles son: notConfigured, enabled y disabled. |
| Bluetooth | Habilitación | Define si un usuario puede habilitar Bluetooth. Los valores posibles son: notConfigured, enabled y disabled. |
| wirelessWideAreaNetwork | Habilitación | Define si un usuario puede habilitar la red inalámbrica de área extensa. Los valores posibles son: notConfigured, enabled y disabled. |
| nearFieldCommunication | Habilitación | Define si un usuario puede habilitar la comunicación de campo cercano. Los valores posibles son: notConfigured, enabled y disabled. |
| Wifi | Habilitación | Define si un usuario puede habilitar wi-fi. Los valores posibles son: notConfigured, enabled y disabled. |
| usbTypeAPort | Habilitación | Define si un usuario puede habilitar el puerto USB de tipo A. Los valores posibles son: notConfigured, enabled y disabled. |
| Sdcard | Habilitación | Define si un usuario puede habilitar el puerto de tarjeta SD. Los valores posibles son: notConfigured, enabled y disabled. |
| wakeOnLAN | Habilitación | Define si un usuario puede habilitar Wake on LAN. Los valores posibles son: notConfigured, enabled y disabled. |
| wakeOnPower | Habilitación | Define si un usuario puede habilitar Wake On Power. Los valores posibles son: notConfigured, enabled y disabled. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto windows10DeviceFirmwareConfigurationInterface 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: 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 201 Created
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"
}
Comentarios
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de