organizationalBrandingProperties-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Ein abstrakter Typ, der Eigenschaften zum Konfigurieren des Brandings einer Organisation verfügbar macht.

Organisationen können ihre Azure Active Directory (Azure AD)-Anmeldeseiten anpassen, die angezeigt werden, wenn sich Benutzer bei den mandantenspezifischen Apps ihrer Organisation anmelden oder wenn Azure AD den Mandanten des Benutzers anhand des Benutzernamens identifiziert. Ein Entwickler kann auch die Brandinginformationen des Unternehmens lesen und seine App-Erfahrung so anpassen, dass sie speziell für den angemeldeten Benutzer mithilfe des Brandings des Unternehmens angepasst wird.

Sie können die Sprache Ihrer ursprünglichen Konfiguration nicht so ändern, wie sie durch das organizationalBranding-Objekt dargestellt wird. Unternehmen können jedoch basierend auf dem Gebietsschema ein anderes Branding hinzufügen. Sprachspezifisches Branding finden Sie im OrganizationalBrandingLocalization-Objekt .

Hinweis

Um benutzerdefiniertes Branding hinzuzufügen, müssen Sie über Azure Active Directory (Azure AD) Premium 1, Premium 2 oder Office 365 (für Office 365-Apps) verfügen. Weitere Informationen zu Lizenzierung und Editionen finden Sie unter "Registrieren für Azure AD Premium".

Azure AD Premium Editionen sind für Kunden in China verfügbar, die die weltweite Instanz von Azure Active Directory verwenden. Azure AD Premium Editionen werden derzeit nicht im Azure-Dienst unterstützt, der von 21Vianet in China betrieben wird. Weitere Informationen erhalten Sie im Azure Active Directory Forum.

Methoden

Keine.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Backgroundcolor	Zeichenfolge	Farbe, die anstelle des Hintergrundbilds in Verbindungen mit geringer Bandbreite angezeigt wird. Es wird empfohlen, dass Sie die Primärfarbe Ihres Bannerlogos oder Ihrer Organisationsfarbe verwenden. Geben Sie dies im Hexadezimalformat an, z. B. ist #FFFFFFWeiß .
Backgroundimage	Stream	Bild, das 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 Image reduziert die Bandbreitenanforderungen und beschleunigt das Laden der Seite.
backgroundImageRelativeUrl	Zeichenfolge	Eine relative URL für die backgroundImage-Eigenschaft, die mit einer CDN Basis-URL aus der cdnList kombiniert wird, um die von einem CDN bereitgestellte Version bereitzustellen. Schreibgeschützt.
bannerLogo	Stream	Eine Bannerversion Ihres Firmenlogos, die auf der Anmeldeseite angezeigt wird. Die zulässigen Typen sind PNG oder JPEG, die nicht größer als 36 × 245 Pixel sind. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden.
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.
cdnList	String-Sammlung	Eine Liste der Basis-URLs für alle verfügbaren CDN Anbieter, die die Ressourcen der aktuellen Ressource bedienen. Mehrere CDN Anbieter werden gleichzeitig für hohe Verfügbarkeit von Leseanforderungen verwendet. Schreibgeschützt.
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 128 Zeichen nicht überschreiten.
customCannotAccessYourAccountText	Zeichenfolge	Eine Zeichenfolge, die die Standardeinstellung "Kann nicht auf Ihr Konto zugreifen?" ersetzen soll. SSPR-Hyperlinktext (Self-Service Password Reset) auf der Anmeldeseite. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten.
customCannotAccessYourAccountUrl	Zeichenfolge	Eine benutzerdefinierte URL, um die Standard-URL der Self-Service-Kennwortzurücksetzung (Self-Service Password Reset, SSPR) zu ersetzen: "Kann nicht auf Ihr Konto zugegriffen werden?" Hyperlink auf der Anmeldeseite. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und 128 Zeichen nicht überschreiten. NICHT VERWENDEN. Verwenden Sie stattdessen customAccountResetCredentialsUrl .
customForgotMyPasswordText	Zeichenfolge	Eine Zeichenfolge zum Ersetzen des Standardmäßigen Hyperlinktexts "Kennwort vergessen" im Anmeldeformular. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten.
customPrivacyAndCookiesText	Zeichenfolge	Eine Zeichenfolge zum Ersetzen des standardmäßigen Hyperlinktexts "Datenschutz und Cookies" in der Fußzeile. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten.
customPrivacyAndCookiesUrl	Zeichenfolge	Eine benutzerdefinierte URL, um die Standard-URL des Hyperlinks "Datenschutz und Cookies" in der Fußzeile zu ersetzen. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und 128 Zeichen nicht überschreiten.
customResetItNowText	Zeichenfolge	Eine Zeichenfolge zum Ersetzen des Standardmäßigen Hyperlinktexts "Jetzt zurücksetzen" im Anmeldeformular. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten. VERWENDEN SIE NICHT: Die Anpassung des Hyperlinktexts "Jetzt zurücksetzen" wird derzeit nicht unterstützt.
customTermsOfUseText	Zeichenfolge	Eine Zeichenfolge zum Ersetzen des standardmäßigen Hyperlinktexts "Nutzungsbedingungen" in der Fußzeile. Dieser Text muss im Unicode-Format vorliegen und darf 256 Zeichen nicht überschreiten.
customTermsOfUseUrl	Zeichenfolge	Eine benutzerdefinierte URL, um die Standard-URL des Hyperlinks "Nutzungsbedingungen" in der Fußzeile zu ersetzen. Diese URL muss im ASCII-Format vorliegen, oder Nicht-ASCII-Zeichen müssen URL-codiert sein und 128 Zeichen nicht überschreiten.
Favicon	Stream	Ein benutzerdefiniertes Symbol (Favicon), um ein Standardmäßiges Microsoft-Produkt-Favicon auf einem Azure AD Mandanten zu ersetzen.
faviconRelativeUrl	Zeichenfolge	Eine relative URL für das obige Favicon, die mit einer CDN Basis-URL aus der cdnList kombiniert wird, um die von einem CDN bereitgestellte Version bereitzustellen. Schreibgeschützt.
headerBackgroundColor	Zeichenfolge	Die RGB-Farbe, die angewendet werden soll, um die Farbe der Kopfzeile anzupassen.
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 Großbuchstabencode aus zwei Buchstaben ist. Beispiel: Englisch (USA) lautet en-US. Die ID für das Standardmäßige /Branding sind immer die Zeichenfolgentypen 0 oder default. Schreibgeschützt. HINWEIS: Mehrere Brandings für ein einzelnes Gebietsschema werden derzeit nicht unterstützt.
loginPageTextVisibilitySettings	loginPageTextVisibilitySettings	Stellt die verschiedenen Texte dar, die auf der Anmeldeseite für einen Mandanten ausgeblendet werden können.
signInPageText	Zeichenfolge	Text, der am unteren Rand des Anmeldefelds angezeigt wird. Verwenden Sie dies, um zusätzliche Informationen, z. B. die Telefonnummer, an Ihren Helpdesk oder eine rechtliche Erklärung zu übermitteln. Dieser Text muss im Unicode-Format vorliegen und darf 1024 Zeichen nicht überschreiten.
squareLogo	Stream	Eine quadratische Version Ihres Unternehmenslogos, die in Windows 10 Windows-Willkommensseite 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 sind. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden.
squareLogoRelativeUrl	Zeichenfolge	Eine relative URL für die squareLogo-Eigenschaft, die mit einer CDN Basis-URL aus der cdnList kombiniert wird, um die von einem CDN bereitgestellte Version bereitzustellen. Schreibgeschützt.
usernameHintText	Zeichenfolge	Eine Zeichenfolge, die als Hinweis im Textfeld für den Benutzernamen auf dem Anmeldebildschirm angezeigt wird. Dieser Text muss ein Unicode-Code ohne Verknüpfungen oder Code sein und darf 64 Zeichen nicht überschreiten.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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