Aktualisieren von intuneBrandingProfile
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.
Aktualisieren sie die Eigenschaften eines intuneBrandingProfile-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Globaler Dienst | 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
PATCH /deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die 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-Sammlung | Liste der Bereichstags, die dem Brandingprofil zugewiesen sind |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes IntuneBrandingProfile-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
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 200 OK
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"
]
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für