IntuneBrandingProfile erstellen

Artikel
09/13/2021
4 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung 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.

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des intuneBrandingProfile-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein IntuneBrandingProfile erstellen.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Profilschlüssel
Profilename	Zeichenfolge	Name des Profils
profileDescription	Zeichenfolge	Beschreibung des Profils
isDefaultProfile	Boolean	Boolescher Wert, der angibt, ob das Profil standardmäßig verwendet wird oder nicht
createdDateTime	DateTimeOffset	Zeitpunkt, zu dem das BrandingProfile erstellt wurde
lastModifiedDateTime	DateTimeOffset	Zeitpunkt der letzten Änderung des BrandingProfile
displayName	Zeichenfolge	Name des Unternehmens/der Organisation, der Endbenutzern angezeigt wird
themeColor	rgbColor	Primäre Designfarbe, die in den Unternehmensportal-Anwendungen und im Webportal verwendet wird
showLogo	Boolean	Boolescher Wert, der angibt, ob die vom Administrator bereitgestellten Logobilder angezeigt werden oder nicht
showDisplayNameNextToLogo	Boolean	Boolescher Wert, der angibt, ob der vom Administrator angegebene Anzeigename neben dem Logobild angezeigt wird oder nicht
themeColorLogo	mimeContent	Logobild, das in Unternehmensportal Apps mit einem Designfarbhintergrund hinter dem Logo angezeigt wird
lightBackgroundLogo	mimeContent	Logobild, das in Unternehmensportal Apps mit hellem Hintergrund hinter dem Logo angezeigt wird
landingPageCustomizedImage	mimeContent	Angepasstes Bild, das auf Unternehmensportal App-Angebotsseite angezeigt wird
contactITName	String	Name der für den IT-Support zuständigen Person/Organisation
contactITPhoneNumber	String	Telefon Nummer der Person/Organisation, die für den IT-Support verantwortlich ist
contactITEmailAddress	String	E-Mail-Adresse der für den IT-Support zuständigen Person/Organisation
contactITNotes	String	Textkommentare zur Person/Organisation, die für den IT-Support verantwortlich ist
onlineSupportSiteUrl	String	URL zur IT-Helpdesk-Website des Unternehmens/der Organisation
onlineSupportSiteName	String	Anzeigename der IT-Helpdesk-Website des Unternehmens/der Organisation
privacyUrl	String	URL zur Datenschutzrichtlinie des Unternehmens/der Organisation
customPrivacyMessage	Zeichenfolge	Textkommentare zu dem, auf was der Administrator auf dem Gerät keinen Zugriff hat
customCanSeePrivacyMessage	Zeichenfolge	Textkommentare dazu, auf welchen Zugriff der Administrator auf dem Gerät hat
customCantSeePrivacyMessage	Zeichenfolge	Textkommentare zu dem, auf was der Administrator auf dem Gerät keinen Zugriff hat
isRemoveDeviceDisabled	Boolesch	Boolescher Wert, der angibt, ob der Administrator die Aktion "Gerät entfernen" auf Unternehmensgeräten deaktiviert hat.
isFactoryResetDisabled	Boolean	Boolescher Wert, der angibt, ob der Administrator die Aktion "Zurücksetzen auf Werkseinstellungen" auf Unternehmensgeräten deaktiviert hat.
companyPortalBlockedActions	companyPortalBlockedAction-Sammlung	Sammlung blockierter Aktionen im Unternehmensportal gemäß Plattform- und Gerätebesitztypen.
showAzureADEnterpriseApps	Boolean	Boolescher Wert, der angibt, ob AzureAD Enterprise Apps in Unternehmensportal
showOfficeWebApps	Boolesch	Boolescher Wert, der angibt, ob Office WebApps in Unternehmensportal
sendDeviceOwnershipChangePushNotification	Boolesch	Boolescher Wert, der angibt, ob eine Pushbenachrichtigung an Benutzer gesendet wird, wenn der Besitzertyp des Geräts von "Privat" in "Unternehmen" geändert wird
enrollmentAvailability	enrollmentAvailabilityOptions	Benutzerdefinierter Geräteregistrierungsfluss, der dem Endbenutzer angezeigt wird. Mögliche Werte sind: `availableWithPrompts`, `availableWithoutPrompts` und `unavailable`.
disableClientTelemetry	Boolean	Gilt für Telemetrie, die von allen Clients an den Intune-Dienst gesendet wird. Wenn deaktiviert, werden alle proaktiven Problembehandlungs- und Problemwarnungen innerhalb des Clients deaktiviert, und Telemetrieeinstellungen werden für den Gerätebenutzer inaktiv oder ausgeblendet angezeigt.
roleScopeTagIds	Zeichenfolgenauflistung	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: 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"
  ]
}

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

IntuneBrandingProfile erstellen

Voraussetzungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback