Crear androidDeviceOwnerEnrollmentProfile
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 androidDeviceOwnerEnrollmentProfile .
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/androidDeviceOwnerEnrollmentProfiles
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 androidDeviceOwnerEnrollmentProfile.
En la tabla siguiente se muestran las propiedades necesarias al crear androidDeviceOwnerEnrollmentProfile.
Propiedad | Tipo | Descripción |
---|---|---|
accountId | Cadena | GUID del espacio empresarial al que pertenece el perfil de inscripción. |
id | Cadena | GUID único del perfil de inscripción. |
displayName | Cadena | Nombre para mostrar del perfil de inscripción. |
description | Cadena | Descripción del perfil de inscripción. |
enrollmentMode | androidDeviceOwnerEnrollmentMode | El modo de inscripción de los dispositivos que usan este perfil de inscripción. Los valores posibles son: corporateOwnedDedicatedDevice , corporateOwnedFullyManaged , corporateOwnedWorkProfile , corporateOwnedAOSPUserlessDevice y corporateOwnedAOSPUserAssociatedDevice . |
enrollmentTokenType | androidDeviceOwnerEnrollmentTokenType | Tipo de token de inscripción para un perfil de inscripción. Los valores posibles son: default , corporateOwnedDedicatedDeviceWithAzureADSharedMode y deviceStaging . |
createdDateTime | DateTimeOffset | Fecha y hora en que se creó el perfil de inscripción. |
lastModifiedDateTime | DateTimeOffset | Fecha y hora en que se modificó el perfil de inscripción por última vez. |
tokenValue | Cadena | Valor del token creado más recientemente para este perfil de inscripción. |
tokenCreationDateTime | DateTimeOffset | Fecha y hora en que se creó el token creado más recientemente. |
tokenExpirationDateTime | DateTimeOffset | Fecha y hora en que expirará el token creado más recientemente. |
enrolledDeviceCount | Int32 | Número total de dispositivos Android que se han inscrito con este perfil de inscripción. |
enrollmentTokenUsageCount | Int32 | Número total de dispositivos AOSP que se han inscrito con el token actual. Valores válidos de 0 a 20000 |
qrCodeContent | Cadena | Cadena usada para generar un código QR para el token. |
qrCodeImage | mimeContent | Cadena usada para generar un código QR para el token. |
roleScopeTagIds | Colección de cadenas | Lista de etiquetas de ámbito para esta instancia de entity. |
configureWifi | Booleano | Booleano que indica que la red Wi-Fi debe configurarse durante el aprovisionamiento de dispositivos. Cuando se establece en TRUE, el aprovisionamiento de dispositivos usará Wi-Fi propiedades relacionadas para conectarse automáticamente a redes Wi-Fi. Cuando se establece en FALSE o indefinido, se omitirán otras propiedades relacionadas Wi-Fi. El valor predeterminado es TRUE. Se devuelve de forma predeterminada. |
wifiSsid | Cadena | Cadena que contiene el ssid de inicio de sesión de wi-fi |
wifiPassword | Cadena | Cadena que contiene la contraseña de inicio de sesión de wi-fi |
wifiSecurityType | aospWifiSecurityType | Cadena que contiene el tipo de seguridad wi-fi. Los valores posibles son: none , wpa y wep . |
wifiHidden | Booleano | Booleano que indica si las redes Wifi ocultas están habilitadas |
isTeamsDeviceProfile | Booleano | Boolean que indica si este perfil es un perfil de dispositivo Android AOSP para Teams. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created
código de respuesta y un objeto androidDeviceOwnerEnrollmentProfile en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles
Content-type: application/json
Content-length: 981
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
"accountId": "Account Id value",
"displayName": "Display Name value",
"description": "Description value",
"enrollmentMode": "corporateOwnedFullyManaged",
"enrollmentTokenType": "corporateOwnedDedicatedDeviceWithAzureADSharedMode",
"tokenValue": "Token Value value",
"tokenCreationDateTime": "2017-01-01T00:01:38.5314127-08:00",
"tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
"enrolledDeviceCount": 3,
"enrollmentTokenUsageCount": 9,
"qrCodeContent": "Qr Code Content value",
"qrCodeImage": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"configureWifi": true,
"wifiSsid": "Wifi Ssid value",
"wifiPassword": "Wifi Password value",
"wifiSecurityType": "wpa",
"wifiHidden": true,
"isTeamsDeviceProfile": true
}
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: 1153
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
"accountId": "Account Id value",
"id": "a8d0245e-245e-a8d0-5e24-d0a85e24d0a8",
"displayName": "Display Name value",
"description": "Description value",
"enrollmentMode": "corporateOwnedFullyManaged",
"enrollmentTokenType": "corporateOwnedDedicatedDeviceWithAzureADSharedMode",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"tokenValue": "Token Value value",
"tokenCreationDateTime": "2017-01-01T00:01:38.5314127-08:00",
"tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
"enrolledDeviceCount": 3,
"enrollmentTokenUsageCount": 9,
"qrCodeContent": "Qr Code Content value",
"qrCodeImage": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"configureWifi": true,
"wifiSsid": "Wifi Ssid value",
"wifiPassword": "Wifi Password value",
"wifiSecurityType": "wpa",
"wifiHidden": true,
"isTeamsDeviceProfile": true
}