Actualizar intuneBrandingProfile
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 intuneBrandingProfile .
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) | DeviceManagementApps.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | DeviceManagementApps.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
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 intuneBrandingProfile .
En la tabla siguiente se muestran las propiedades necesarias al crear intuneBrandingProfile.
Propiedad | Tipo | Descripción |
---|---|---|
id | Cadena | Clave de perfil |
profileName | Cadena | Nombre del perfil |
profileDescription | Cadena | Descripción del perfil |
isDefaultProfile | Booleano | Boolean que representa si el perfil se usa como valor predeterminado o no |
createdDateTime | DateTimeOffset | Hora en que se creó BrandingProfile |
lastModifiedDateTime | DateTimeOffset | Hora a la que se modificó por última vez BrandingProfile |
displayName | Cadena | Nombre de empresa o organización que se muestra a los usuarios finales |
themeColor | rgbColor | Color del tema principal usado en las aplicaciones de Portal de empresa y el portal web |
showLogo | Booleano | Boolean que representa si se muestran o no las imágenes de logotipo proporcionadas por el administrador |
showDisplayNameNextToLogo | Booleano | Boolean que representa si el nombre para mostrar proporcionado por el administrador se mostrará junto a la imagen del logotipo o no. |
themeColorLogo | mimeContent | Imagen del logotipo que se muestra en Portal de empresa aplicaciones que tienen un fondo de color de tema detrás del logotipo |
lightBackgroundLogo | mimeContent | Imagen del logotipo mostrada en aplicaciones Portal de empresa que tienen un fondo claro detrás del logotipo |
landingPageCustomizedImage | mimeContent | Imagen personalizada que se muestra en Portal de empresa página de aterrizaje de aplicaciones |
contactITName | Cadena | Nombre de la persona o organización responsable del soporte técnico de TI |
contactITPhoneNumber | Cadena | Número de teléfono de la persona o organización responsable del soporte técnico de TI |
contactITEmailAddress | Cadena | Dirección de correo electrónico de la persona o organización responsable del soporte técnico de TI |
contactITNotes | Cadena | Comentarios de texto sobre la persona u organización responsable del soporte técnico de TI |
onlineSupportSiteUrl | Cadena | Dirección URL al sitio del departamento de soporte técnico de TI de la empresa o organización |
onlineSupportSiteName | Cadena | Nombre para mostrar del sitio del departamento de soporte técnico de TI de la empresa o organización |
privacyUrl | Cadena | Dirección URL a la directiva de privacidad de la empresa o la organización |
customPrivacyMessage | Cadena | Comentarios de texto sobre lo que el administrador no tiene acceso en el dispositivo |
customCanSeePrivacyMessage | Cadena | Comentarios de texto sobre a qué tiene acceso el administrador en el dispositivo |
customCantSeePrivacyMessage | Cadena | Comentarios de texto sobre lo que el administrador no tiene acceso en el dispositivo |
isRemoveDeviceDisabled | Booleano | Boolean que representa si el administrador ha deshabilitado la acción "Quitar dispositivo" en dispositivos corporativos. |
isFactoryResetDisabled | Booleano | Boolean que representa si el administrador ha deshabilitado la acción "Restablecimiento de fábrica" en dispositivos corporativos. |
companyPortalBlockedActions | colección companyPortalBlockedAction | Recopilación de acciones bloqueadas en el portal de empresa según los tipos de propiedad de plataforma y dispositivo. |
disableDeviceCategorySelection | Booleano | Boolean que indica si la selección de categorías de dispositivo se mostrará en Portal de empresa |
showAzureADEnterpriseApps | Booleano | Boolean que indica si AzureAD Enterprise Apps se mostrará en Portal de empresa |
showOfficeWebApps | Booleano | Boolean que indica si Office WebApps se mostrará en Portal de empresa |
showConfigurationManagerApps | Booleano | Boolean que indica si se mostrará Configuration Manager Apps en Portal de empresa |
sendDeviceOwnershipChangePushNotification | Booleano | Booleano que indica si se envía una notificación push a los usuarios cuando el tipo de propiedad del dispositivo cambia de personal a corporativo. |
disponibilidad de inscripción | enrollmentAvailabilityOptions | Flujo de inscripción de dispositivos personalizado que se muestra al usuario final. Los valores posibles son: availableWithPrompts , availableWithoutPrompts y unavailable . |
disableClientTelemetry | Booleano | Se aplica a la telemetría enviada desde todos los clientes al servicio Intune. Cuando se deshabilita, se desactivan todas las advertencias proactivas de solución de problemas y problemas del cliente y la configuración de telemetría aparece inactiva u oculta para el usuario del dispositivo. |
roleScopeTagIds | Colección de cadenas | Lista de etiquetas de ámbito asignadas al perfil de personalización de marca |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto intuneBrandingProfile actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
Content-type: application/json
Content-length: 2059
{
"@odata.type": "#microsoft.graph.intuneBrandingProfile",
"profileName": "Profile Name value",
"profileDescription": "Profile Description value",
"isDefaultProfile": true,
"displayName": "Display Name value",
"themeColor": {
"@odata.type": "microsoft.graph.rgbColor",
"r": 1,
"g": 1,
"b": 1
},
"showLogo": true,
"showDisplayNameNextToLogo": true,
"themeColorLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"lightBackgroundLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"landingPageCustomizedImage": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"contactITName": "Contact ITName value",
"contactITPhoneNumber": "Contact ITPhone Number value",
"contactITEmailAddress": "Contact ITEmail Address value",
"contactITNotes": "Contact ITNotes value",
"onlineSupportSiteUrl": "https://example.com/onlineSupportSiteUrl/",
"onlineSupportSiteName": "Online Support Site Name value",
"privacyUrl": "https://example.com/privacyUrl/",
"customPrivacyMessage": "Custom Privacy Message value",
"customCanSeePrivacyMessage": "Custom Can See Privacy Message value",
"customCantSeePrivacyMessage": "Custom Cant See Privacy Message value",
"isRemoveDeviceDisabled": true,
"isFactoryResetDisabled": true,
"companyPortalBlockedActions": [
{
"@odata.type": "microsoft.graph.companyPortalBlockedAction",
"platform": "androidForWork",
"ownerType": "company",
"action": "remove"
}
],
"disableDeviceCategorySelection": true,
"showAzureADEnterpriseApps": true,
"showOfficeWebApps": true,
"showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true,
"enrollmentAvailability": "availableWithoutPrompts",
"disableClientTelemetry": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
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: 2231
{
"@odata.type": "#microsoft.graph.intuneBrandingProfile",
"id": "fcd6136c-136c-fcd6-6c13-d6fc6c13d6fc",
"profileName": "Profile Name value",
"profileDescription": "Profile Description value",
"isDefaultProfile": true,
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"displayName": "Display Name value",
"themeColor": {
"@odata.type": "microsoft.graph.rgbColor",
"r": 1,
"g": 1,
"b": 1
},
"showLogo": true,
"showDisplayNameNextToLogo": true,
"themeColorLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"lightBackgroundLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"landingPageCustomizedImage": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"contactITName": "Contact ITName value",
"contactITPhoneNumber": "Contact ITPhone Number value",
"contactITEmailAddress": "Contact ITEmail Address value",
"contactITNotes": "Contact ITNotes value",
"onlineSupportSiteUrl": "https://example.com/onlineSupportSiteUrl/",
"onlineSupportSiteName": "Online Support Site Name value",
"privacyUrl": "https://example.com/privacyUrl/",
"customPrivacyMessage": "Custom Privacy Message value",
"customCanSeePrivacyMessage": "Custom Can See Privacy Message value",
"customCantSeePrivacyMessage": "Custom Cant See Privacy Message value",
"isRemoveDeviceDisabled": true,
"isFactoryResetDisabled": true,
"companyPortalBlockedActions": [
{
"@odata.type": "microsoft.graph.companyPortalBlockedAction",
"platform": "androidForWork",
"ownerType": "company",
"action": "remove"
}
],
"disableDeviceCategorySelection": true,
"showAzureADEnterpriseApps": true,
"showOfficeWebApps": true,
"showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true,
"enrollmentAvailability": "availableWithoutPrompts",
"disableClientTelemetry": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}