intuneBrandingProfile erstellen

Artikel
11/22/2024

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Erstellen Sie ein neues intuneBrandingProfile-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementApps.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementApps.ReadWrite.All

HTTP-Anforderung

POST /deviceManagement/intuneBrandingProfiles

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das intuneBrandingProfile-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von intuneBrandingProfile erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	String	Profilschlüssel
profileName	String	Name des Profils
profileDescription	String	Beschreibung des Profils
isDefaultProfile	Boolesch	Boolescher Wert, der angibt, ob das Profil als Standard verwendet wird oder nicht
createdDateTime	DateTimeOffset	Zeitpunkt, zu dem das BrandingProfile erstellt wurde
lastModifiedDateTime	DateTimeOffset	Zeitpunkt der letzten Änderung des BrandingProfiles
displayName	String	Name des Unternehmens/organization, der endbenutzern angezeigt wird
themeColor	rgbColor	Primäre Designfarbe, die in den Unternehmensportal-Anwendungen und im Webportal verwendet wird
showLogo	Boolesch	Boolescher Wert, der angibt, ob die vom Administrator bereitgestellten Logobilder angezeigt werden oder nicht
showDisplayNameNextToLogo	Boolesch	Boolescher Wert, der angibt, ob der vom Administrator angegebene Anzeigename neben dem Logobild angezeigt wird oder nicht
themeColorLogo	mimeContent	Logobild, das in Unternehmensportal-Apps angezeigt wird, die einen Designfarbhintergrund hinter dem Logo haben
lightBackgroundLogo	mimeContent	Logobild, das in Unternehmensportal-Apps angezeigt wird, die einen hellen Hintergrund hinter dem Logo haben
landingPageCustomizedImage	mimeContent	Benutzerdefiniertes Bild, das auf der Startseite Unternehmensportal Apps angezeigt wird
contactITName	String	Name der Person/organization, die für den IT-Support verantwortlich ist
contactITPhoneNumber	String	Telefonnummer der für den IT-Support zuständigen Person/organization
contactITEmailAddress	String	E-Mail-Adresse der für den IT-Support zuständigen Person/organization
contactITNotes	String	Textkommentare zur Person/organization, die für den IT-Support zuständig ist
onlineSupportSiteUrl	String	URL zur IT-Helpdesk-Website des Unternehmens/organization
onlineSupportSiteName	String	Anzeigename der It-Helpdesk-Website des Unternehmens/organization
privacyUrl	String	URL zur Datenschutzrichtlinie des Unternehmens/organization
customPrivacyMessage	String	Textkommentare zu dem, worauf der Administrator auf dem Gerät keinen Zugriff hat
customCanSeePrivacyMessage	String	Textkommentare zu den Zugriffen des Administrators auf dem Gerät
customCantSeePrivacyMessage	String	Textkommentare zu dem, worauf der Administrator auf dem Gerät keinen Zugriff hat
isRemoveDeviceDisabled	Boolesch	Boolescher Wert, der angibt, ob der Administrator die Aktion "Gerät entfernen" auf unternehmenseigenen Geräten deaktiviert hat.
isFactoryResetDisabled	Boolesch	Boolescher Wert, der angibt, ob der Administrator die Aktion "Zurücksetzen auf Werkseinstellungen" auf unternehmenseigenen Geräten deaktiviert hat.
companyPortalBlockedActions	companyPortalBlockedAction-Sammlung	Sammlung blockierter Aktionen im Unternehmensportal gemäß Plattform- und Gerätebesitztypen.
disableDeviceCategorySelection	Boolesch	Boolescher Wert, der angibt, ob die Gerätekategorieauswahl in Unternehmensportal
showAzureADEnterpriseApps	Boolesch	Boolescher Wert, der angibt, ob AzureAD Enterprise Apps in Unternehmensportal
showOfficeWebApps	Boolesch	Boolescher Wert, der angibt, ob Office WebApps in Unternehmensportal
showConfigurationManagerApps	Boolesch	Boolescher Wert, der angibt, ob Configuration Manager Apps in Unternehmensportal
sendDeviceOwnershipChangePushNotification	Boolesch	Boolescher Wert, der angibt, ob eine Pushbenachrichtigung an Benutzer gesendet wird, wenn sich ihr Gerätebesitztyp von "Persönlich" in "Unternehmen" ändert
enrollmentAvailability	enrollmentAvailabilityOptions	Benutzerdefinierter Geräteregistrierungsflow, der dem Endbenutzer angezeigt wird. Mögliche Werte sind: `availableWithPrompts`, `availableWithoutPrompts` und `unavailable`.
disableClientTelemetry	Boolesch	Gilt für Telemetriedaten, die von allen Clients an den Intune-Dienst gesendet werden. Wenn diese Option deaktiviert ist, werden alle proaktiven Problembehandlungs- und Problemwarnungen innerhalb des Clients deaktiviert, und Telemetrieeinstellungen werden für den Gerätebenutzer inaktiv oder ausgeblendet angezeigt.
roleScopeTagIds	String collection	Liste der Bereichstags, die dem Brandingprofil zugewiesen sind

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein intuneBrandingProfile-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

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

Freigeben über

intuneBrandingProfile erstellen

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback

Zusätzliche Ressourcen