Mettre à jour intuneBrandingProfile

Article
11/22/2024

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Mettez à jour les propriétés d’un objet intuneBrandingProfile .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	✅

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	DeviceManagementApps.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	DeviceManagementApps.ReadWrite.All

Requête HTTP

PATCH /deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter	application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet intuneBrandingProfile .

Le tableau suivant présente les propriétés requises lorsque vous créez intuneBrandingProfile.

Propriété	Type	Description
id	String	Clé de profil
profileName	String	Nom du profil
profileDescription	String	Description du profil
isDefaultProfile	Boolean	Valeur booléenne qui indique si le profil est utilisé par défaut ou non
createdDateTime	DateTimeOffset	Heure de création de BrandingProfile
lastModifiedDateTime	DateTimeOffset	Heure de la dernière modification de BrandingProfile
displayName	String	Nom de la société/organization affiché aux utilisateurs finaux
themeColor	rgbColor	Couleur du thème principal utilisée dans les applications Portail d'entreprise et le portail web
showLogo	Boolean	Valeur booléenne qui indique si les images de logo fournies par l’administrateur sont affichées ou non
showDisplayNameNextToLogo	Boolean	Boolean qui indique si le nom d’affichage fourni par l’administrateur s’affiche en regard de l’image du logo ou non
themeColorLogo	mimeContent	Image de logo affichée dans Portail d'entreprise applications qui ont un arrière-plan de couleur de thème derrière le logo
lightBackgroundLogo	mimeContent	Image du logo affichée dans Portail d'entreprise applications qui ont un arrière-plan clair derrière le logo
landingPageCustomizedImage	mimeContent	Image personnalisée affichée dans la page d’accueil des applications Portail d'entreprise
contactITName	String	Nom de la personne/organization responsable du support informatique
contactITPhoneNumber	String	Numéro de téléphone de la personne/organization responsable du support informatique
contactITEmailAddress	String	Adresse de messagerie de la personne/organization responsable du support informatique
contactITNotes	String	Commentaires texte concernant la personne/organization responsable du support informatique
onlineSupportSiteUrl	String	URL du site du support technique informatique de l’entreprise/du organization
onlineSupportSiteName	String	Nom d’affichage du site du support technique informatique de l’entreprise/du organization
privacyUrl	String	URL de la politique de confidentialité de l’entreprise/organization
customPrivacyMessage	String	Commentaires texte concernant ce à quoi l’administrateur n’a pas accès sur l’appareil
customCanSeePrivacyMessage	String	Commentaires texte concernant ce à quoi l’administrateur a accès sur l’appareil
customCantSeePrivacyMessage	String	Commentaires texte concernant ce à quoi l’administrateur n’a pas accès sur l’appareil
isRemoveDeviceDisabled	Boolean	Valeur booléenne qui indique si l’administrateur a désactivé l’action « Supprimer l’appareil » sur les appareils appartenant à l’entreprise.
isFactoryResetDisabled	Boolean	Valeur booléenne qui indique si l’administrateur a désactivé l’action « Réinitialisation aux paramètres d’usine » sur les appareils appartenant à l’entreprise.
companyPortalBlockedActions	collection companyPortalBlockedAction	Collection d’actions bloquées sur le portail d’entreprise en fonction des types de propriété de plateforme et d’appareil.
disableDeviceCategorySelection	Boolean	Valeur booléenne qui indique si la sélection de la catégorie d’appareil sera affichée dans Portail d'entreprise
showAzureADEnterpriseApps	Boolean	Valeur booléenne qui indique si AzureAD Enterprise Apps sera affiché dans Portail d'entreprise
showOfficeWebApps	Boolean	Boolean qui indique si Office WebApps sera affiché dans Portail d'entreprise
showConfigurationManagerApps	Boolean	Boolean qui indique si Configuration Manager Apps s’affiche dans Portail d'entreprise
sendDeviceOwnershipChangePushNotification	Boolean	Boolean qui indique si une notification Push est envoyée aux utilisateurs lorsque leur type de propriété d’appareil passe de personnel à entreprise
enrollmentAvailability	enrollmentAvailabilityOptions	Flux d’inscription d’appareil personnalisé affiché pour l’utilisateur final. Les valeurs possibles sont `availableWithPrompts`, `availableWithoutPrompts` et `unavailable`.
disableClientTelemetry	Boolean	S’applique aux données de télémétrie envoyées par tous les clients au service Intune. Lorsqu’ils sont désactivés, tous les avertissements proactifs de résolution des problèmes et de problèmes au sein du client sont désactivés et les paramètres de télémétrie apparaissent inactifs ou masqués pour l’utilisateur de l’appareil.
roleScopeTagIds	String collection	Liste des balises d’étendue affectées au profil de personnalisation

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet intuneBrandingProfile mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

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

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

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

Partager via

Mettre à jour intuneBrandingProfile

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemple

Demande

Réponse

Commentaires

Ressources supplémentaires