Créer intuneBrandingProfile
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é/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 | 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 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 | Chaîne | Nom de la personne/organization responsable du support informatique |
| contactITPhoneNumber | Chaîne | Numéro de téléphone de la personne/organization responsable du support informatique |
| contactITEmailAddress | Chaîne | Adresse de messagerie de la personne/organization responsable du support informatique |
| contactITNotes | Chaîne | Commentaires texte concernant la personne/organization responsable du support informatique |
| onlineSupportSiteUrl | Chaîne | URL du site du support technique informatique de l’entreprise/du organization |
| onlineSupportSiteName | Chaîne | Nom d’affichage du site du support technique informatique de l’entreprise/du organization |
| privacyUrl | Chaîne | URL de la politique de confidentialité de l’entreprise/organization |
| 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 | Valeur booléenne qui indique si la sélection de la catégorie d’appareil sera affichée dans Portail d'entreprise |
| showAzureADEnterpriseApps | Valeur booléenne | Valeur booléenne qui indique si AzureAD Enterprise Apps sera affiché dans Portail d'entreprise |
| showOfficeWebApps | Valeur booléenne | Boolean qui indique si Office WebApps sera affiché dans Portail d'entreprise |
| showConfigurationManagerApps | Valeur booléenne | Boolean qui indique si Configuration Manager Apps s’affiche dans 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"
]
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour