Créer intuneBrandingProfile

Espace de noms : microsoft.graph

Important : Les API Graph Microsoft sous la version /bêta sont sujettes à modification . l’utilisation en production n’est pas prise en charge.

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

Crée un objet intuneBrandingProfile.

Conditions préalables

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.
Accepter application/json

Corps de la demande

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

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’intuneBrandingProfile.

Propriété Type Description
id Chaîne Clé de profil
profileName Chaîne Nom du profil
profileDescription Chaîne Description du profil
isDefaultProfile Boolean Booléen qui représente 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 l’entreprise/de l’organisation qui s’affiche pour les utilisateurs finaux
themeColor rgbColor Couleur de thème principale utilisée dans les applications Portail d'entreprise et le portail web
showLogo Booléen Booléen qui représente si les images de logo fournies par l’administrateur sont affichées ou non
showDisplayNameNextToLogo Booléen Booléen qui représente si le nom d’affichage fourni par l’administrateur s’affichera à côté 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 de logo affichée dans Portail d'entreprise applications dont l’arrière-plan est clair derrière le logo
landingPageCustomizedImage mimeContent Image personnalisée affichée dans la page Portail d'entreprise d’accueil des applications
contactITName String Nom de la personne/de l’organisation responsable du support technique
contactITPhoneNumber String Téléphone de la personne/de l’organisation responsable du support technique
contactITEmailAddress String Adresse de messagerie de la personne/de l’organisation responsable du support technique
contactITNotes String Commentaires textuels concernant la personne/l’organisation responsable du support technique
onlineSupportSiteUrl String URL du site de l’équipe de secours de l’entreprise/de l’organisation
onlineSupportSiteName String Nom d’affichage du site de l’équipe de secours de l’entreprise/de l’organisation
privacyUrl String 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 de 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 Boolean Booléen qui représente si l’administrateur a désactivé l’action « Supprimer l’appareil » sur les appareils d’entreprise.
isFactoryResetDisabled Boolean Booléen qui représente si l’administrateur a désactivé l’action « Réinitialisation aux usine » sur les appareils d’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.
showAzureADEnterpriseApps Boolean Booléen qui indique si AzureAD Enterprise Apps sera affiché dans Portail d'entreprise
showOfficeWebApps Boolean Booléen qui indique si Office WebApps seront affichés dans Portail d'entreprise
sendDeviceOwnershipChangePushNotification Boolean Booléen qui indique si une notification Push est envoyée aux utilisateurs lorsque le type de propriété de leur appareil change de personnel à entreprise
enrollmentAvailability enrollmentAvailabilityOptions Flux d’inscription d’appareil personnalisé affiché à l’utilisateur final. Les valeurs possibles sont availableWithPrompts, availableWithoutPrompts et unavailable.
disableClientTelemetry Boolean S’applique à la télémétrie envoyée par tous les clients au service Intune. Lorsqu’il est désactivé, tous les avertissements de résolution et d’émission de problèmes proactifs 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 branding

Réponse

Si elle réussit, cette méthode renvoie un code de réponse et un 201 Created 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: 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"
  ]
}

Réponse

Voici un exemple de la 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: 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"
  ]
}