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"
  ]
}