Atualizar intuneBrandingProfile

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.

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

Atualize as propriedades de um objeto intuneBrandingProfile .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA 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.
Aplicativo	DeviceManagementApps.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}

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 da solicitação, forneça uma representação JSON para o objeto intuneBrandingProfile .

A tabela a seguir mostra as propriedades necessárias ao criar 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	Booliano que representa se o perfil é usado como padrão 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 exibido para usuários finais
themeColor	rgbColor	Cor do tema principal usada nos aplicativos Portal da Empresa e no portal da Web
showLogo	Booliano	Booliano que representa se as imagens de logotipo fornecidas pelo administrador são mostradas ou não
showDisplayNameNextToLogo	Booliano	Booliano que representa se o nome de exibição fornecido pelo administrador será mostrado ao lado da imagem do logotipo ou não
themeColorLogo	mimeContent	Imagem de logotipo exibida em Portal da Empresa aplicativos que têm um plano de fundo de cor do tema por trás do logotipo
lightBackgroundLogo	mimeContent	Imagem de logotipo exibida em Portal da Empresa aplicativos que têm um plano de fundo leve atrás do logotipo
landingPageCustomizedImage	mimeContent	Imagem personalizada exibida na página de destino Portal da Empresa aplicativos
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 email da pessoa/organização responsável pelo suporte de TI
contactITNotes	Cadeia de caracteres	Comentários de texto sobre a pessoa/organização responsável pelo suporte de TI
onlineSupportSiteUrl	Cadeia de caracteres	URL para o site de ajuda de TI da empresa/organização
onlineSupportSiteName	Cadeia de caracteres	Nome de exibição do site de helpdesk 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	Boolean que representa se o administrador desabilitou a ação "Remover Dispositivo" em dispositivos corporativos.
isFactoryResetDisabled	Booliano	Boolean que representa se o administrador desabilitou a ação 'Factory Reset' em dispositivos corporativos.
companyPortalBlockedActions	coleção companyPortalBlockedAction	Coleção de ações bloqueadas no portal da empresa de acordo com tipos de propriedade de plataforma e dispositivo.
disableDeviceCategorySelection	Booliano	Booliano que indica se a Seleção de Categoria de Dispositivo será mostrada em Portal da Empresa
showAzureADEnterpriseApps	Booliano	Booliano que indica se os Aplicativos Empresariais do AzureAD serão mostrados no Portal da Empresa
showOfficeWebApps	Booliano	Booliano que indica se o Office WebApps será mostrado em Portal da Empresa
showConfigurationManagerApps	Booliano	Booliano que indica se Configuration Manager Aplicativos serão mostrados no Portal da Empresa
sendDeviceOwnershipChangePushNotification	Booliano	Booleano que indica se uma notificação por push é enviada aos usuários quando o tipo de propriedade do dispositivo muda de pessoal para corporativo
enrollmentAvailability	enrollmentAvailabilityOptions	Fluxo de registro de dispositivo personalizado exibido para o usuário 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 desabilitado, todos os avisos proativos de solução de problemas e problemas no cliente são desativados e as configurações de telemetria aparecem inativas ou ocultas para o usuário do dispositivo.
roleScopeTagIds	String collection	Lista de marcas de escopo atribuídas ao perfil de identidade visual

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e um objeto intuneBrandingProfile atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

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