Créer intuneBrandingProfile

Article
08/02/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.

Créez 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

POST /deviceManagement/intuneBrandingProfiles

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	Chaîne	Clé de profil
profileName	Chaîne	Nom du profil
profileDescription	Chaîne	Description du profil
isDefaultProfile	Valeur booléenne	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	Chaîne	Nom de la société/de l’organisation affiché aux utilisateurs finaux
themeColor	rgbColor	Couleur du thème principal utilisée dans les applications portail d’entreprise et le portail web
showLogo	Valeur booléenne	Valeur booléenne qui indique si les images de logo fournies par l’administrateur sont affichées ou non
showDisplayNameNextToLogo	Valeur booléenne	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 les applications Portail d’entreprise qui ont un arrière-plan de couleur de thème derrière le logo
lightBackgroundLogo	mimeContent	Image du logo affichée dans les applications Portail d’entreprise 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	Chaîne	Nom de la personne ou de l’organisation responsable du support informatique
contactITPhoneNumber	Chaîne	Numéro de téléphone de la personne ou de l’organisation responsable du support informatique
contactITEmailAddress	Chaîne	Adresse de messagerie de la personne ou de l’organisation responsable du support informatique
contactITNotes	Chaîne	Commentaires texte concernant la personne/l’organisation responsable du support informatique
onlineSupportSiteUrl	Chaîne	URL du site du support technique informatique de l’entreprise ou de l’organisation
onlineSupportSiteName	Chaîne	Nom d’affichage du site du support technique informatique de l’entreprise ou de l’organisation
privacyUrl	Chaîne	URL de la politique de confidentialité de l’entreprise/de l’organisation
customPrivacyMessage	Chaîne	Commentaires texte concernant ce à quoi l’administrateur n’a pas accès sur l’appareil
customCanSeePrivacyMessage	Chaîne	Commentaires texte concernant ce à quoi l’administrateur a accès sur l’appareil
customCantSeePrivacyMessage	Chaîne	Commentaires texte concernant ce à quoi l’administrateur n’a pas accès sur l’appareil
isRemoveDeviceDisabled	Valeur booléenne	Valeur booléenne qui indique si l’administrateur a désactivé l’action « Supprimer l’appareil » sur les appareils appartenant à l’entreprise.
isFactoryResetDisabled	Valeur booléenne	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	Valeur booléenne	Boolean qui indique si la sélection de la catégorie d’appareil sera affichée dans le portail d’entreprise
showAzureADEnterpriseApps	Valeur booléenne	Boolean qui indique si AzureAD Enterprise Apps sera affiché dans le portail d’entreprise
showOfficeWebApps	Valeur booléenne	Valeur booléenne qui indique si les applications web Office seront affichées dans le portail d’entreprise
showConfigurationManagerApps	Valeur booléenne	Valeur booléenne qui indique si les applications Configuration Manager seront affichées dans le portail d’entreprise
sendDeviceOwnershipChangePushNotification	Valeur booléenne	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	Valeur booléenne	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 201 Created code de réponse et un objet intuneBrandingProfile dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

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

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

Partager via

Créer intuneBrandingProfile

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemple

Demande

Réponse

Commentaires

Ressources supplémentaires