Crear intuneBrandingProfile

Espacio de nombres: microsoft.graph

Importante: Las API Graph Microsoft 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.

Requisitos previos

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 Se requiere <token> de portador.
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 para 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 predeterminado o no
createdDateTime DateTimeOffset Hora en la que se creó BrandingProfile
lastModifiedDateTime DateTimeOffset Hora en 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 el portal web Portal de empresa aplicaciones y 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 de logotipo mostrada en Portal de empresa aplicaciones que tienen un fondo de color de tema detrás del logotipo
lightBackgroundLogo mimeContent Imagen de logotipo mostrada en Portal de empresa aplicaciones que tienen un fondo claro detrás del logotipo
landingPageCustomizedImage mimeContent Imagen personalizada que se muestra en Portal de empresa de aterrizaje de aplicaciones
contactITName Cadena Nombre de la persona u organización responsable del soporte técnico de TI
contactITPhoneNumber Cadena Teléfono número de la persona o organización responsable del soporte técnico de TI
contactITEmailAddress Cadena Dirección de correo electrónico de la persona u organización responsable del soporte técnico de TI
contactITNotes Cadena Comentarios de texto relativos a la persona u organización responsable del soporte técnico de TI
onlineSupportSiteUrl Cadena Dirección URL del sitio de soporte técnico de TI de la empresa o organización
onlineSupportSiteName Cadena Nombre para mostrar del sitio de soporte técnico de TI de la empresa o organización
privacyUrl Cadena Dirección URL de la directiva de privacidad de la empresa o 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 la empresa según los tipos de propiedad de dispositivos y plataformas.
showAzureADEnterpriseApps Booleano Boolean que indica si las aplicaciones Enterprise AzureAD se mostrarán en Portal de empresa
showOfficeWebApps Booleano Boolean que indica si Office WebApps se mostrará en Portal de empresa
sendDeviceOwnershipChangePushNotification Booleano Boolean que indica si se envía una notificación de inserción a los usuarios cuando el tipo de propiedad del dispositivo cambia de personal a corporativo
enrollmentAvailability enrollmentAvailabilityOptions Flujo de inscripción de dispositivo 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 de Intune. Cuando se deshabilita, se desactivan todas las advertencias proactivas de solución de problemas y problemas en el cliente y la configuración de telemetría aparece inactiva u oculta para el usuario del dispositivo.
roleScopeTagIds Colección string Lista de etiquetas de ámbito asignadas al perfil de personal de marca

Respuesta

Si se realiza correctamente, este método devuelve un código 201 Created 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: 1975

{
  "@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"
    }
  ],
  "showAzureADEnterpriseApps": true,
  "showOfficeWebApps": true,
  "sendDeviceOwnershipChangePushNotification": true,
  "enrollmentAvailability": "availableWithoutPrompts",
  "disableClientTelemetry": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 2147

{
  "@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"
    }
  ],
  "showAzureADEnterpriseApps": true,
  "showOfficeWebApps": true,
  "sendDeviceOwnershipChangePushNotification": true,
  "enrollmentAvailability": "availableWithoutPrompts",
  "disableClientTelemetry": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}