organizationalBrandingProperties-RessourcentyporganizationalBrandingProperties resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.

Hinweis

Für das Hinzufügen von benutzerdefiniertem Branding müssen Sie Azure Active Directory Premium 1-, Premium 2- oder Basic-Editionen verwenden oder über eine Microsoft 365-Lizenz verfügen.Adding custom branding requires you to use Azure Active Directory Premium 1, Premium 2, or Basic editions, or to have a Microsoft 365 license. Weitere Informationen zu Lizenzierung und Editionen finden Sie unter Registrieren für Azure AD Premium.For more information about licensing and editions, see Sign up for Azure AD Premium.

Azure AD Premium- und Basic-Editionen sind für Kunden in China verfügbar, die die weltweite Instanz von Azure Active Directory verwenden.Azure AD Premium and Basic editions are available for customers in China using the worldwide instance of Azure Active Directory. Azure AD Premium- und Basic-Editionen werden derzeit nicht im Azure-Dienst unterstützt, der von 21Vianet in China betrieben wird.Azure AD Premium and Basic editions aren't currently supported in the Azure service operated by 21Vianet in China. Weitere Informationen finden Sie im Azure Active Directory Forum.For more information, talk to us using the Azure Active Directory Forum.

Enthält Details zum Branding der Organisation.Contains details about the organization's branding.

Organisationen können ihre 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 aus dem Benutzernamen identifiziert.Organizations can customize their Azure AD sign-in pages which appear when users sign in to their organization's tenant-specific apps, or when Azure AD identifies the user's tenant from their username. 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 des Unternehmens anzupassen.A developer can also read the company's branding information and customize their app experience to tailor it specifically for the signed-in user using their company's branding.

Unternehmen können unterschiedliche Brandings basierend auf dem Locale hinzufügen.Companies can add different branding based on locale. Locale dient als Schlüssel in allen Anforderungen.Locale serves as a key in all requests.

Hinweis: Branding wird als Eigenschaft in der Organisation mit einer Sammlung von lokalspezifischen Lokalisierungen verfügbar gemacht.Note: Branding is exposed as a property under organization with a collection of locale-specific localizations. organizationalBrandingProperties ist eine abstrakte Klasse, die Eigenschaften für organizationalBranding definiert.organizationalBrandingProperties is an abstract class which defines properties for organizationalBranding.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
CreateCreate organizationalBrandingPropertiesorganizationalBrandingProperties Erstellen Sie organisationsorientiertes Branding mit organizationalBrandingProperties-Objekt.Create organizational branding with organizationalBrandingProperties object.
GetGet organizationalBrandingPropertiesorganizationalBrandingProperties Lesen von Eigenschaften und Beziehungen des organizationalBrandingProperties-Objekts.Read properties and relationships of organizationalBrandingProperties object.
UpdateUpdate organizationalBrandingPropertiesorganizationalBrandingProperties Aktualisieren des organizationalBrandingProperties-Objekts.Update organizationalBrandingProperties object.
LöschenDelete KeineNone OrganizationalBrandingProperties-Objekt löschen.Delete organizationalBrandingProperties object.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
backgroundColorbackgroundColor StringString Farbe, die an Stelle des Hintergrundbilds in Verbindungen mit niedriger Bandbreite angezeigt wird.Color that will appear in place of the background image in low-bandwidth connections. Es wird empfohlen, hier die Hauptfarbe Ihres Bannerlogos oder Ihrer Organisationsfarbe zu verwenden.The primary color of your banner logo or your organization color is recommended to be used here. Geben Sie dies im Hexadezimal an (z. B. weiß #FFFFFF).Specify this in hexadecimal (for example, white is #FFFFFF).
backgroundImagebackgroundImage StreamStream Bild, das als Hintergrund der Anmeldeseite angezeigt wird.Image that appears as the background of the sign in page. PNG oder JPG nicht größer als 1920x1080 und kleiner als 300 KB..png or .jpg not larger than 1920x1080 and smaller than 300kb. Ein kleineres Bild reduziert die Bandbreitenanforderungen und macht seitenlasten effizienter.A smaller image will reduce bandwidth requirements and make page loads more performant.
bannerLogobannerLogo StreamStream Eine Bannerversion Ihres Firmenlogos, die auf der Anmeldeseite angezeigt wird.A banner version of your company logo which appears appears on the sign-in page. .png oder .jpg nicht größer als 36x245px..png or .jpg no larger than 36x245px. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden.We recommend using a transparent image with no padding around the logo.
idid StringString Dies ist eine id, geerbt von microsoft.graph.entity, ist das Locale, das den ISO 639-Standard für Sprache an gibt, z. B. Englisch ist "en-us" oder "en".This is an id, inherited from microsoft.graph.entity, is the locale specifying the ISO 639 standard for language, for example English is "en-us" or "en". Wenn wir funktionen mit mehreren Brandings für ein Locale verfügbar machen, kann dies in Zukunft geändert werden.Going forward if we expose functionality to have multiple brandings for one locale, this can be changed. Beachten Sie, dass die ID für Default /branding immer "und" ist, bis wir schlüssellose Singletons haben.Note that id for Default /branding is always 'und' until we have keyless singletons. Schreibgeschützt.Read-only.
signInPageTextsignInPageText StringString Text, der am unteren Rand des Anmeldefelds angezeigt wird.Text that appears at the bottom of the sign-in box. Sie können dies verwenden, um zusätzliche Informationen, z. B. die Telefonnummer, an Ihren Helpdesk oder eine rechtliche Erklärung zu kommunizieren.You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. Dieser Text muss Unicode sein und darf 1024 Zeichen nicht überschreiten.This text must be Unicode and not exceed 1024 characters.
squareLogosquareLogo StreamStream Quadratische Version Ihres Firmenlogos.Square version of your company logo. Dies wird in windows 10 out-of-box (OOBE)-Erfahrungen und angezeigt, wenn Windows Autopilot für die Bereitstellung aktiviert ist.This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. PNG oder JPG nicht größer als 240x240px und nicht mehr als 10 KB groß..png or .jpg no larger than 240x240px and no more than 10kb in size. Es wird empfohlen, ein transparentes Bild ohne Abstand um das Logo zu verwenden.We recommend using a transparent image with no padding around the logo.
usernameHintTextusernameHintText StringString Zeichenfolge, die als Hinweis im Textfeld Benutzername auf dem Anmeldebildschirm angezeigt wird.String that shows as the hint in the username textbox on the sign in screen. Dieser Text muss Unicode ohne Links oder Code sein und darf 64 Zeichen nicht überschreiten.This text must be Unicode, without links or code, and can't exceed 64 characters.

BeziehungenRelationships

KeineNone

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

{
  "backgroundColor": "String",
  "backgroundImage": "Stream",
  "bannerLogo": "Stream",
  "id": "String (identifier)",
  "signInPageText": "String",
  "squareLogo": "Stream",
  "usernameHintText": "String"
}