Créer intuneBrandingProfile

Article
09/13/2021
4 minutes de lecture

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

Créer intuneBrandingProfile

Cette page est-elle utile ?

Conditions préalables

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemple

Demande

Réponse

Commentaires