Creación de 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.
Cree un nuevo 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
POST /deviceManagement/intuneBrandingProfiles
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 201 Created
código de respuesta y un objeto intuneBrandingProfile en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles
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 201 Created
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"
]
}