Actualizar 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.
Actualice las propiedades de un 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
PATCH /deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}
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 200 OK
código de respuesta y un objeto androidDeviceOwnerEnrollmentProfile actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}
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 200 OK
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
}