Criar intuneBrandingProfile

Artigo
08/02/2024

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto intuneBrandingProfile .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/intuneBrandingProfiles

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar	application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto intuneBrandingProfile.

A tabela seguinte mostra as propriedades necessárias quando cria o intuneBrandingProfile.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Chave de Perfil
profileName	Cadeia de caracteres	Nome do perfil
profileDescription	Cadeia de caracteres	Descrição do perfil
isDefaultProfile	Booliano	Booleano que representa se o perfil é utilizado como predefinido ou não
createdDateTime	DateTimeOffset	Hora em que o BrandingProfile foi criado
lastModifiedDateTime	DateTimeOffset	Hora em que o BrandingProfile foi modificado pela última vez
displayName	Cadeia de caracteres	Nome da empresa/organização que é apresentado aos utilizadores finais
themeColor	rgbColor	Cor do tema principal utilizada nas aplicações Portal da Empresa e no portal Web
showLogo	Booliano	Booleano que representa se as imagens do logótipo fornecidas pelo administrador são apresentadas ou não
showDisplayNameNextToLogo	Booliano	Valor booleano que representa se o nome a apresentar fornecido pelo administrador será apresentado junto à imagem do logótipo ou não
themeColorLogo	mimeContent	Imagem do logótipo apresentada nas aplicações Portal da Empresa que têm um fundo de cor do tema atrás do logótipo
lightBackgroundLogo	mimeContent	Imagem do logótipo apresentada nas aplicações Portal da Empresa que têm um fundo claro atrás do logótipo
landingPageCustomizedImage	mimeContent	Imagem personalizada apresentada na página de destino de aplicações Portal da Empresa
contactITName	Cadeia de caracteres	Nome da pessoa/organização responsável pelo suporte de TI
contactITPhoneNumber	Cadeia de caracteres	Número de telefone da pessoa/organização responsável pelo suporte de TI
contactITEmailAddress	Cadeia de caracteres	Endereço de e-mail da pessoa/organização responsável pelo suporte de TI
contactITNotes	Cadeia de caracteres	Enviar comentários por texto sobre a pessoa/organização responsável pelo suporte de TI
onlineSupportSiteUrl	Cadeia de caracteres	URL para o site de suporte técnico de TI da empresa/organização
onlineSupportSiteName	Cadeia de caracteres	Nome a apresentar do site de suporte técnico de TI da empresa/organização
privacyUrl	Cadeia de caracteres	URL para a política de privacidade da empresa/organização
customPrivacyMessage	Cadeia de caracteres	Comentários de texto sobre o que o administrador não tem acesso no dispositivo
customCanSeePrivacyMessage	Cadeia de caracteres	Comentários de texto sobre o que o administrador tem acesso no dispositivo
customCantSeePrivacyMessage	Cadeia de caracteres	Comentários de texto sobre o que o administrador não tem acesso no dispositivo
isRemoveDeviceDisabled	Booliano	Booleano que representa se o administrador desativou a ação "Remover Dispositivo" em dispositivos pertencentes à empresa.
isFactoryResetDisabled	Booliano	Valor booleano que representa se o administrador desativou a ação "Reposição de Fábrica" em dispositivos pertencentes à empresa.
companyPortalBlockedActions	coleção companyPortalBlockedAction	Coleção de ações bloqueadas no portal da empresa de acordo com os tipos de propriedade da plataforma e do dispositivo.
disableDeviceCategorySelection	Booliano	Valor booleano que indica se a Seleção da Categoria do Dispositivo será apresentada no Portal da Empresa
mostrarAzureADEnterpriseApps	Booliano	Valor booleano que indica se as Aplicações Empresariais do AzureAD serão apresentadas no Portal da Empresa
showOfficeWebApps	Booliano	Valor booleano que indica se o Office WebApps será apresentado no Portal da Empresa
showConfigurationManagerApps	Booliano	Booleano que indica se as Aplicações Configuration Manager serão apresentadas no Portal da Empresa
sendDeviceOwnershipChangePushNotification	Booliano	Valor booleano que indica se uma notificação push é enviada aos utilizadores quando o tipo de propriedade do dispositivo muda de pessoal para empresarial
enrollmentAvailability	enrollmentAvailabilityOptions	Fluxo de inscrição de dispositivos personalizado apresentado ao utilizador final. Os valores possíveis são: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.
disableClientTelemetry	Booliano	Aplica-se à telemetria enviada de todos os clientes para o serviço Intune. Quando desativado, todos os avisos proativos de resolução de problemas e problemas no cliente são desativados e as definições de telemetria aparecem inativas ou ocultas para o utilizador do dispositivo.
roleScopeTagIds	Coleção de cadeias de caracteres	Lista de etiquetas de âmbito atribuídas ao perfil de imagem corporativa

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto intuneBrandingProfile no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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"
  ]
}

Compartilhar via

Criar intuneBrandingProfile

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplo

Solicitação

Resposta

Comentários

Recursos adicionais