Freigeben über

organizationalBranding-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Enthält Details zum Standardbranding der Organisation. Erbt von organizationalBrandingProperties.

Organisationen können ihre Microsoft Entra-Anmeldeseiten anpassen, die angezeigt werden, wenn sich Benutzer bei den mandantenspezifischen Apps ihrer Organisation anmelden oder wenn Microsoft Entra ID den Mandanten des Benutzers anhand ihres Benutzernamens identifiziert. Ein Entwickler kann auch die Brandinginformationen des Unternehmens lesen und seine App-Erfahrung anpassen, um sie speziell für den angemeldeten Benutzer mithilfe des Brandings seines Unternehmens anzupassen.

Sie können die Sprache Ihrer ursprünglichen Konfiguration nicht ändern. Unternehmen können jedoch basierend auf dem Gebietsschema ein anderes Branding hinzufügen. Informationen zum sprachspezifischen Branding finden Sie unter dem organizationalBrandingLocalization-Objekt .

Hinweis

Zum Hinzufügen eines benutzerdefinierten Brandings müssen Sie entweder über Lizenzen für Microsoft Entra ID P1 oder P2, Premium 2 oder Office 365 (für Office 365-Apps) verfügen. Weitere Informationen zu Lizenzierung und Editionen finden Sie unter Registrieren für Microsoft Entra ID P1 oder P2.

Microsoft Entra ID P1- oder P2-Editionen sind für Kunden in China verfügbar, die die weltweite Instanz von Microsoft Entra ID verwenden. Microsoft Entra ID P1- oder P2-Editionen werden derzeit nicht im Azure-Dienst unterstützt, der von 21Vianet in China betrieben wird. Weitere Informationen erfahren Sie im Microsoft Entra-Forum.

Methoden

Methode Rückgabetyp Beschreibung
Get organizationalBranding Lesen der Eigenschaften und Beziehungen eines organizationalBranding-Objekts .
Update Keine Aktualisieren sie die Eigenschaften eines organizationalBranding-Objekts .

Eigenschaften

Eigenschaft Typ Beschreibung
backgroundColor Zeichenfolge Farbe, die anstelle des Hintergrundbilds in Verbindungen mit geringer Bandbreite angezeigt wird. Es wird empfohlen, die Primärfarbe Ihres Bannerlogos oder der Farbe Ihrer Organisation zu verwenden. Geben Sie dies im Hexadezimalformat an, z. B. ist #FFFFFFweiß . Geerbt von organizationalBrandingProperties.
backgroundImage Stream Abbildung, die als Hintergrund der Anmeldeseite angezeigt wird. Die zulässigen Typen sind PNG oder JPEG nicht kleiner als 300 KB und nicht größer als 1920 × 1080 Pixel. Ein kleineres Bild reduziert die Bandbreitenanforderungen und führt dazu, dass die Seite schneller geladen wird. Geerbt von organizationalBrandingProperties.
backgroundImageRelativeUrl Zeichenfolge Eine relative URL für die backgroundImage-Eigenschaft , die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
bannerLogo Stream Eine Bannerversion Ihres Unternehmenslogos, die auf der Anmeldeseite angezeigt wird. Die zulässigen Typen sind PNG oder JPEG, die nicht größer als 245 x 36 Pixel sind. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden. Geerbt von organizationalBrandingProperties.
bannerLogoRelativeUrl Zeichenfolge Eine relative URL für die bannerLogo-Eigenschaft , die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die schreibgeschützte Version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
cdnList String-Sammlung Eine Liste der Basis-URLs für alle verfügbaren CDN-Anbieter, die die Ressourcen der aktuellen Ressource bereitstellen. Für die Hochverfügbarkeit von Leseanforderungen werden gleichzeitig mehrere CDN-Anbieter verwendet. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
contentCustomization contentCustomization Stellt die verschiedenen Inhaltsoptionen dar, die während des Authentifizierungsablaufs für einen Mandanten angepasst werden sollen.

ANMERKUNG: Wird nur für Kundenmandanten von Microsoft Entra ID unterstützt. Geerbt von organizationalBrandingProperties.
customAccountResetCredentialsUrl Zeichenfolge Eine benutzerdefinierte URL zum Zurücksetzen von Kontoanmeldeinformationen. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und dürfen 128 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
customCannotAccessYourAccountText Zeichenfolge Eine Zeichenfolge, die den standardmäßigen Linktext "Kann nicht auf Ihr Konto zugreifen?" auf der Anmeldeseite ersetzen. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
customCannotAccessYourAccountUrl Zeichenfolge Eine benutzerdefinierte URL, die die Standard-URL des Links zur Self-Service-Kennwortzurücksetzung (Self-Service Password Reset, SSPR) "Kann nicht auf Ihr Konto zugreifen?" auf der Anmeldeseite ersetzen soll. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und dürfen 128 Zeichen nicht überschreiten.

NICHT VERWENDEN. Verwenden Sie stattdessen customAccountResetCredentialsUrl . Geerbt von organizationalBrandingProperties.
customCSS Stream CSS-Formatierung, die auf der Anmeldeseite angezeigt wird. Das zulässige Format ist nur .css Format und nicht größer als 25 KB. Geerbt von organizationalBrandingProperties.
customCSSRelativeUrl Zeichenfolge Eine relative URL für die customCSS-Eigenschaft , die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
customForgotMyPasswordText Zeichenfolge Eine Zeichenfolge zum Ersetzen des Standardlinktexts "Kennwort vergessen" im Anmeldeformular. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
customPrivacyAndCookiesText Zeichenfolge Eine Zeichenfolge, um den standardmäßigen Linktext "Datenschutz und Cookies" in der Fußzeile zu ersetzen. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
customPrivacyAndCookiesUrl Zeichenfolge Eine benutzerdefinierte URL zum Ersetzen der Standard-URL des Links "Datenschutz und Cookies" in der Fußzeile. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und dürfen 128 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
customResetItNowText Zeichenfolge Eine Zeichenfolge, die den standardmäßigen Linktext "jetzt zurücksetzen" im Anmeldeformular ersetzt. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten.

NICHT VERWENDEN: Die Anpassung des Linktexts "Jetzt zurücksetzen" wird derzeit nicht unterstützt. Geerbt von organizationalBrandingProperties.
customTermsOfUseText Zeichenfolge Eine Zeichenfolge, die den Standardtext des Links "Nutzungsbedingungen" in der Fußzeile ersetzt. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
customTermsOfUseUrl Zeichenfolge Eine benutzerdefinierte URL zum Ersetzen der Standard-URL des Links "Nutzungsbedingungen" in der Fußzeile. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und 128 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.
Favicon Stream Ein benutzerdefiniertes Symbol (Favicon) zum Ersetzen eines Standardmäßigen Microsoft-Produktfavicons in einem Microsoft Entra-Mandanten. Geerbt von organizationalBrandingProperties.
faviconRelativeUrl Zeichenfolge Eine relative URL für das obige Favicon, die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
headerBackgroundColor Zeichenfolge Die RGB-Farbe, die angewendet werden soll, um die Farbe des Headers anzupassen. Geerbt von organizationalBrandingProperties.
headerLogo Stream Ein Unternehmenslogo, das in der Kopfzeile der Anmeldeseite angezeigt wird. Die zulässigen Typen sind PNG oder JPEG, die nicht größer als 245 x 36 Pixel sind. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden. Geerbt von organizationalBrandingProperties.
headerLogoRelativeUrl Zeichenfolge Eine relative URL für die headerLogo-Eigenschaft , die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die schreibgeschützte Version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
id Zeichenfolge Ein Bezeichner, der das mithilfe von Kulturnamen angegebene Gebietsschema darstellt. Kulturnamen folgen dem RFC 1766-Standard im Format "languagecode2-country/regioncode2", wobei "languagecode2" ein aus ISO 639-1 abgeleiteter Kleinbuchstabencode ist und "country/regioncode2" ein aus ISO 3166 abgeleiteter Code in Großbuchstaben ist. Beispielsweise ist en-USUS-Englisch . Die ID für das Standard-/Branding ist immer der String-Typ 0 oder default. Schreibgeschützt.

ANMERKUNG: Mehrere Brandings für ein einzelnes Gebietsschema werden derzeit nicht unterstützt.
loginPageLayoutConfiguration loginPageLayoutConfiguration Stellt die Layoutkonfiguration dar, die auf der Anmeldeseite für einen Mandanten angezeigt werden soll. Geerbt von organizationalBrandingProperties.
loginPageTextVisibilitySettings loginPageTextVisibilitySettings Stellt die verschiedenen Texte dar, die auf der Anmeldeseite für einen Mandanten ausgeblendet werden können. Geerbt von organizationalBrandingProperties.
signInPageText Zeichenfolge Text, der unten im Anmeldefeld angezeigt wird. Verwenden Sie dies, um zusätzliche Informationen wie die Telefonnummer an Ihren Helpdesk oder eine rechtliche Erklärung zu übermitteln. Dieser Text muss im Unicode-Format vorliegen und darf 1.024 Zeichen nicht überschreiten.
squareLogo Stream Eine quadratische Version Ihres Unternehmenslogos, die in Windows 10 Out-of-Box-Umgebungen (OOBE) angezeigt wird und wenn Windows Autopilot für die Bereitstellung aktiviert ist. Zulässige Typen sind PNG oder JPEG, die nicht größer als 240 x 240 Pixel und nicht mehr als 10 KB groß sind. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden. Geerbt von organizationalBrandingProperties.
squareLogoRelativeUrl Zeichenfolge Eine relative URL für die squareLogo-Eigenschaft , die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
squareLogoDark Stream Eine quadratische dunkle Version Ihres Unternehmenslogos, die in Windows 10 Out-of-Box-Umgebungen (OOBE) angezeigt wird und wenn Windows Autopilot für die Bereitstellung aktiviert ist. Zulässige Typen sind PNG oder JPEG, die nicht größer als 240 x 240 Pixel und nicht mehr als 10 KB groß sind. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden. Geerbt von organizationalBrandingProperties.
squareLogoDarkRelativeUrl Zeichenfolge Eine relative URL für die squareLogoDark-Eigenschaft , die mit einer CDN-Basis-URL aus der cdnList kombiniert wird, um die version bereitzustellen, die von einem CDN bereitgestellt wird. Schreibgeschützt. Geerbt von organizationalBrandingProperties.
usernameHintText Zeichenfolge Eine Zeichenfolge, die als Hinweis im Textfeld benutzername auf dem Anmeldebildschirm angezeigt wird. Bei diesem Text muss es sich um einen Unicode-Text ohne Links oder Code handeln und darf 64 Zeichen nicht überschreiten. Geerbt von organizationalBrandingProperties.

Beziehungen

Beziehung Typ Beschreibung
Lokalisierungen organizationalBrandingLocalization-Sammlung Fügen Sie basierend auf einem Gebietsschema ein anderes Branding hinzu.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.organizationalBranding",
  "id": "String (identifier)",
  "backgroundColor": "String",
  "backgroundImage": "Stream",
  "backgroundImageRelativeUrl": "String",
  "bannerLogo": "Stream",
  "bannerLogoRelativeUrl": "String",
  "cdnList": [
    "String"
  ],
  "signInPageText": "String",
  "squareLogo": "Stream",
  "squareLogoRelativeUrl": "String",
  "squareLogoDark": "Stream",
  "squareLogoDarkRelativeUrl": "String",
  "usernameHintText": "String",
  "contentCustomization": {
    "@odata.type": "microsoft.graph.contentCustomization"
  },  
  "customAccountResetCredentialsUrl": "String",
  "customCannotAccessYourAccountText": "String",
  "customCannotAccessYourAccountUrl": "String",
  "customCSS": "Stream",
  "customCSSRelativeUrl": "String",
  "customForgotMyPasswordText": "String",
  "customPrivacyAndCookiesText": "String",
  "customPrivacyAndCookiesUrl": "String",
  "customResetItNowText": "String",
  "customTermsOfUseText": "String",
  "customTermsOfUseUrl": "String",
  "favicon": "Stream",
  "faviconRelativeUrl": "String",
  "headerBackgroundColor": "String",
  "headerLogo": "Stream",
  "headerLogoRelativeUrl": "String",
  "loginPageLayoutConfiguration": {
    "@odata.type": "microsoft.graph.loginPageLayoutConfiguration"
  },
  "loginPageTextVisibilitySettings": {
    "@odata.type": "microsoft.graph.loginPageTextVisibilitySettings"
  }
}