Freigeben über


Microsoft.Graph-Anwendungen

Berechtigungen

Wählen Sie die Berechtigung oder Berechtigungen aus, die als am wenigsten privilegierte für diese API gekennzeichnet sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App sie benötigt. Ausführliche Informationen zu delegierten und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Hinweis

Berechtigungen für persönliche Microsoft-Konten können nicht zum Bereitstellen von Microsoft Graph-Ressourcen verwendet werden, die in Bicep-Dateien deklariert sind.

Berechtigungstyp Berechtigungen mit geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Application.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Application.ReadWrite.All Nicht verfügbar.
Application Application.ReadWrite.OwnedBy Application.ReadWrite.All

Ressourcenformat

Um eine Microsoft.Graph/Applications-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Graph/applications@v1.0' = {
  addIns: [
    {
      id: 'string'
      properties: [
        {
          key: 'string'
          value: 'string'
        }
      ]
      type: 'string'
    }
  ]
  api: {
    acceptMappedClaims: bool
    knownClientApplications: 'string'
    oauth2PermissionScopes: [
      {
        adminConsentDescription: 'string'
        adminConsentDisplayName: 'string'
        id: 'string'
        isEnabled: bool
        type: 'string'
        userConsentDescription: 'string'
        userConsentDisplayName: 'string'
        value: 'string'
      }
    ]
    preAuthorizedApplications: [
      {
        appId: 'string'
        delegatedPermissionIds: [
          'string'
        ]
      }
    ]
    requestedAccessTokenVersion: int
  }
  appRoles: [
    {
      allowedMemberTypes: [
        'string'
      ]
      description: 'string'
      displayName: 'string'
      id: 'string'
      isEnabled: bool
      value: 'string'
    }
  ]
  defaultRedirectUri: 'string'
  description: 'string'
  disabledByMicrosoftStatus: 'string'
  displayName: 'string'
  groupMembershipClaims: 'string'
  identifierUris: [
    'string'
  ]
  info: {
    marketingUrl: 'string'
    privacyStatementUrl: 'string'
    supportUrl: 'string'
    termsOfServiceUrl: 'string'
  }
  isDeviceOnlyAuthSupported: bool
  isFallbackPublicClient: bool
  keyCredentials: [
    {
      customKeyIdentifier: 'string'
      displayName: 'string'
      endDateTime: 'string'
      key: 'string'
      keyId: 'string'
      startDateTime: 'string'
      type: 'string'
      usage: 'string'
    }
  ]
  logo: 'string'
  nativeAuthenticationApisEnabled: 'string'
  notes: 'string'
  optionalClaims: {
    accessToken: [
      {
        additionalProperties: [
          'string'
        ]
        essential: bool
        name: 'string'
        source: 'string'
      }
    ]
    idToken: [
      {
        additionalProperties: [
          'string'
        ]
        essential: bool
        name: 'string'
        source: 'string'
      }
    ]
    saml2Token: [
      {
        additionalProperties: [
          'string'
        ]
        essential: bool
        name: 'string'
        source: 'string'
      }
    ]
  }
  parentalControlSettings: {
    countriesBlockedForMinors: [
      'string'
    ]
    legalAgeGroupRule: 'string'
  }
  passwordCredentials: [
    {
      displayName: 'string'
      endDateTime: 'string'
      keyId: 'string'
      startDateTime: 'string'
    }
  ]
  publicClient: {
    redirectUris: [
      'string'
    ]
  }
  requestSignatureVerification: {
    allowedWeakAlgorithms: 'string'
    isSignedRequestRequired: bool
  }
  requiredResourceAccess: [
    {
      resourceAccess: [
        {
          id: 'string'
          type: 'string'
        }
      ]
      resourceAppId: 'string'
    }
  ]
  samlMetadataUrl: 'string'
  serviceManagementReference: 'string'
  servicePrincipalLockConfiguration: {
    allProperties: bool
    credentialsWithUsageSign: bool
    credentialsWithUsageVerify: bool
    isEnabled: bool
    tokenEncryptionKeyId: bool
  }
  signInAudience: 'string'
  spa: {
    redirectUris: [
      'string'
    ]
  }
  tags: [
    'string'
  ]
  tokenEncryptionKeyId: 'string'
  uniqueName: 'string'
  verifiedPublisher: {
    addedDateTime: 'string'
    displayName: 'string'
    verifiedPublisherId: 'string'
  }
  web: {
    homePageUrl: 'string'
    implicitGrantSettings: {
      enableAccessTokenIssuance: bool
      enableIdTokenIssuance: bool
    }
    logoutUrl: 'string'
    redirectUris: [
      'string'
    ]
    redirectUriSettings: [
      {
        index: int
        uri: 'string'
      }
    ]
  }
}

Eigenschaftswerte

applications

Name Beschreibung Wert
addIns Definiert ein benutzerdefiniertes Verhalten, mit dem eine App in bestimmten Kontexten von einem Verbraucherdienst aufgerufen werden kann. Beispielsweise können Anwendungen, die Dateidatenströme rendern können, die addIns-Eigenschaft für die "FileHandler"-Funktionalität festlegen. Auf diese Weise können Dienste wie Microsoft 365 die Anwendung im Kontext eines Dokuments aufrufen, an dem der Benutzer arbeitet. MicrosoftGraphAddIn[]
api Gibt Einstellungen für eine Anwendung an, die eine Web-API implementiert. MicrosoftGraphApiApplication
apiVersion Die Ressourcen-API-Version 'v1.0' (ReadOnly)
appId Der eindeutige Bezeichner für die Anwendung, die einer Anwendung durch die Microsoft Entra-ID zugewiesen ist. Lässt keine NULL-Werte zu. Schreibgeschützt. Alternativschlüssel string (ReadOnly)
applicationTemplateId Eindeutiger Bezeichner der applicationTemplate. Schreibgeschützt. null, wenn die App nicht aus einer Anwendungsvorlage erstellt wurde. string (ReadOnly)
appRoles Die Sammlung von Rollen, die für die Anwendung definiert sind. Mit App-Rollenzuweisungen können diese Rollen Benutzern, Gruppen oder Dienstprinzipalen zugewiesen werden, die anderen Anwendungen zugeordnet sind. Lässt keine NULL-Werte zu. MicrosoftGraphAppRole[]
Zertifizierung Gibt den Zertifizierungsstatus der Anwendung an. MicrosoftGraphCertification (ReadOnly)
createdDateTime Das Datum und die Uhrzeit der Anwendungsregistrierung. Der DateTimeOffset-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Schreibgeschützt string (ReadOnly)
defaultRedirectUri Zeichenfolge
deletedDateTime Datum und Uhrzeit, zu der dieses Objekt gelöscht wurde. Immer NULL, wenn das Objekt nicht gelöscht wurde. string (ReadOnly)
Beschreibung Kostenloses Textfeld, um endbenutzern eine Beschreibung des Anwendungsobjekts bereitzustellen. Die maximal zulässige Größe beträgt 1.024 Zeichen. Zeichenfolge
disabledByMicrosoftStatus Gibt an, ob Microsoft die registrierte Anwendung deaktiviert hat. Mögliche Werte sind: NULL (Standardwert), NotDisabled und DisabledDueToViolationOfServicesAgreement (Gründe sind verdächtige, missbräuchliche oder böswillige Aktivitäten oder eine Verletzung des Microsoft-Servicevertrags) Zeichenfolge
displayName Der Anzeigename für die Anwendung Zeichenfolge (Erforderlich)
groupMembershipClaims Konfiguriert den Gruppenanspruch, der in einem Benutzer- oder OAuth 2.0-Zugriffstoken ausgestellt wurde, das von der Anwendung erwartet wird. Verwenden Sie zum Festlegen dieses Attributs einen der folgenden gültigen Zeichenfolgenwerte: None, SecurityGroup (für Sicherheitsgruppen und Microsoft Entra-Rollen), Alle (dies ruft alle Sicherheitsgruppen, Verteilergruppen und Microsoft Entra-Verzeichnisrollen ab, bei denen der angemeldete Benutzer Mitglied ist). Zeichenfolge
id Der eindeutige Bezeichner für eine Entität. Schreibgeschützt. string (ReadOnly)
identifierUris Dieser Wert wird auch als App-ID-URI bezeichnet, wenn eine Anwendung als Ressourcen-App verwendet wird. Die IdentifierUris fungieren als Präfix für die Bereiche, auf die Sie im Code Ihrer API verweisen, und sie muss global eindeutig sein. Sie können den bereitgestellten Standardwert im Format api://<appId> verwenden oder einen besser lesbaren URI wie https://contoso.com/api angeben. Weitere Informationen zu gültigen IdUris-Mustern und bewährten Methoden finden Sie unter bewährte Methoden für die Microsoft Entra-Anwendungsregistrierung. Lässt keine NULL-Werte zu string[]
info Grundlegende Profilinformationen der Anwendung, z. B. Marketing-, Support-, Nutzungsbedingungen und DATENSCHUTZbestimmungen-URLs. Die Nutzungsbedingungen und Datenschutzbestimmungen werden auf der Oberfläche für die Benutzerzustimmung angezeigt. Weitere Informationen finden Sie unter How to: Add Terms of Service and privacy statement for registered Microsoft Entra apps MicrosoftGraphInformationalUrl
isDeviceOnlyAuthSupported Gibt an, ob diese Anwendung die Geräteauthentifizierung ohne Benutzer unterstützt. Die Standardeinstellung ist „false“. bool
isFallbackPublicClient Gibt den Fallbackanwendungstyp als öffentlicher Client an, z. B. eine installierte Anwendung, die auf einem mobilen Gerät ausgeführt wird. Der Standardwert ist "false", was bedeutet, dass der Fallbackanwendungstyp vertraulicher Client ist, z. B. eine Web-App. Es gibt bestimmte Szenarien, in denen die Microsoft Entra-ID den Clientanwendungstyp nicht ermitteln kann. Beispielsweise der ROPC-Fluss, in dem er konfiguriert ist, ohne einen Umleitungs-URI anzugeben. In diesen Fällen interpretiert Microsoft Entra ID den Anwendungstyp basierend auf dem Wert dieser Eigenschaft. bool
keyCredentials Die Sammlung der Schlüsselanmeldeinformationen, die der Anwendung zugeordnet sind. Lässt keine NULL-Werte zu MicrosoftGraphKeyCredential[]
Logo Das Hauptlogo für die Anwendung. Lässt keine NULL-Werte zu. Zeichenfolge
nativeAuthenticationApisEnabled Gibt an, ob die nativen Authentifizierungs-APIs für die Anwendung aktiviert sind. Die möglichen Werte sind: keine und alle. Der Standardwert ist keine. Weitere Informationen finden Sie unter native Authentifizierung. Zeichenfolge
Notizen Hinweise, die für die Verwaltung der Anwendung relevant sind. Zeichenfolge
optionalClaims Anwendungsentwickler können optionale Ansprüche in ihren Microsoft Entra-Anwendungen konfigurieren, um die Ansprüche anzugeben, die vom Microsoft-Sicherheitstokendienst an ihre Anwendung gesendet werden. Weitere Informationen finden Sie unter How to: Provide optional claims to your app. MicrosoftGraphOptionalClaims
parentalControlSettings Gibt die Jugendschutzeinstellungen für eine Anwendung an. MicrosoftGraphParentalControlSettings
passwordCredentials Die Sammlung von Kennwortanmeldeinformationen, die der Anwendung zugeordnet sind. Lässt keine NULL-Werte zu. MicrosoftGraphPasswordCredential[]
publicClient Gibt Einstellungen für installierte Clients wie Desktop- oder mobile Geräte an. MicrosoftGraphPublicClientApplication
publisherDomain Die überprüfte Herausgeberdomäne für die Anwendung. Schreibgeschützt. Weitere Informationen finden Sie unter How to: Configure an application's publisher domain string (ReadOnly)
requestSignatureVerification Gibt an, ob für diese Anwendung die Microsoft Entra-ID erforderlich ist, um die signierten Authentifizierungsanforderungen zu überprüfen. MicrosoftGraphRequestSignatureVerification
requiredResourceAccess Gibt die Ressourcen an, auf die die Anwendung zugreifen muss. Diese Eigenschaft gibt auch den Satz delegierter Berechtigungen und Anwendungsrollen an, die sie für jede dieser Ressourcen benötigt. Diese Konfiguration des Zugriffs auf die erforderlichen Ressourcen steuert die Zustimmungserfahrung. Es können nicht mehr als 50 Ressourcendienste (APIs) konfiguriert werden. Ab Mitte Oktober 2021 darf die Gesamtzahl der erforderlichen Berechtigungen 400 nicht überschreiten. Weitere Informationen finden Sie unter "Grenzwerte für angeforderte Berechtigungen pro App". Lässt keine NULL-Werte zu MicrosoftGraphRequiredResourceAccess[]
samlMetadataUrl Die URL, unter der der Dienst SAML-Metadaten für den Partnerverbund verfügbar macht. Diese Eigenschaft ist nur für Einzelmandantenanwendungen gültig. NULL-Werte sind zulässig. Zeichenfolge
serviceManagementReference Verweist auf Anwendungs- oder Dienstkontaktinformationen aus einer Dienst- oder Objektverwaltungsdatenbank. NULL-Werte sind zulässig. Zeichenfolge
servicePrincipalLockConfiguration Gibt an, ob vertrauliche Eigenschaften einer mehrinstanzenfähigen Anwendung zur Bearbeitung gesperrt werden sollen, nachdem die Anwendung in einem Mandanten bereitgestellt wurde. NULL-Werte sind zulässig. null standardmäßig. MicrosoftGraphServicePrincipalLockConfiguration
signInAudience Gibt die Microsoft-Konten an, die für die aktuelle Anwendung unterstützt werden. Die möglichen Werte sind: AzureADMyOrg (Standard), AzureADMultipleOrgs, AzureADandPersonalMicrosoftAccount und PersonalMicrosoftAccount. Weitere Informationen finden Sie in der Tabelle. Der Wert dieses Objekts beschränkt auch die Anzahl der Berechtigungen, die eine App anfordern kann. Weitere Informationen finden Sie unter "Grenzwerte für angeforderte Berechtigungen pro App". Der Wert für diese Eigenschaft hat Auswirkungen auf andere App-Objekteigenschaften. Wenn Sie diese Eigenschaft ändern, müssen Sie möglicherweise zuerst andere Eigenschaften ändern. Zeichenfolge
Kurort Gibt Einstellungen für eine Einzelseitenanwendung an, einschließlich Abmelde-URLs und Umleitungs-URIs für Autorisierungscodes und Zugriffstoken. MicrosoftGraphSpaApplication
Tags Benutzerdefinierte Zeichenfolgen, die zum Kategorisieren und Identifizieren der Anwendung verwendet werden können Lässt keine NULL-Werte zu string[]
tokenEncryptionKeyId Gibt die keyId eines öffentlichen Schlüssels aus der KeyCredentials -Auflistung an. Bei der Konfiguration verschlüsselt die Microsoft Entra-ID alle token, auf die sie ausgegeben werden, indem der Schlüssel verwendet wird, auf den diese Eigenschaft verweist. Der Anwendungscode, der das verschlüsselte Token empfängt, muss den zugehörigen privaten Schlüssel verwenden, um das Token zu entschlüsseln, bevor es für den angemeldeten Benutzer bzw. die angemeldete Benutzerin verwendet werden kann. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
Typ Der Ressourcentyp "Microsoft.Graph/applications" (ReadOnly)
uniqueName Der eindeutige Bezeichner, der einer Anwendung zugewiesen und als alternativer Schlüssel verwendet werden kann. Unveränderlich Zeichenfolge (Erforderlich)
verifiedPublisher Gibt den überprüften Herausgeber der Anwendung an. Weitere Informationen dazu, wie die Herausgeberüberprüfung die Anwendungssicherheit, Vertrauenswürdigkeit und Compliance unterstützt, finden Sie unter Publisher-Überprüfung. MicrosoftGraphVerifiedPublisher
web Gibt Einstellungen für eine Webanwendung an. MicrosoftGraphWebApplication

MicrosoftGraphKeyValue

Name Beschreibung Wert
Schlüssel Schlüssel für das Schlüssel-Wert-Paar. Zeichenfolge
value Wert für das Schlüssel-Wert-Paar. Zeichenfolge

MicrosoftGraphAddIn

Name Beschreibung Wert
id Der eindeutige Bezeichner für das addIn-Objekt. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
properties Die Sammlung von Schlüssel-Wert-Paaren, die Parameter definieren, die der verbrauchende Dienst verwenden oder aufrufen kann. Sie müssen diese Eigenschaft angeben, wenn Sie einen POST- oder PATCH-Vorgang für die addIns-Auflistung ausführen. Erforderlich. MicrosoftGraphKeyValue[]
Typ Der eindeutige Name für die Funktionalität, die von der App verfügbar gemacht wird. Zeichenfolge

MicrosoftGraphPermissionScope

Name Beschreibung Wert
adminConsentDescription Eine Beschreibung der delegierten Berechtigungen, die von einem Administrator gelesen werden soll, der die Berechtigung im Namen aller Benutzer erteilt. Dieser Text wird in mandantenweiten Administratorzustimmungsfunktionen angezeigt. Zeichenfolge
adminConsentDisplayName Der Titel der Berechtigung, der von einem Administrator gelesen werden soll, der die Berechtigung im Namen aller Benutzer erteilt. Zeichenfolge
id Eindeutiger delegierter Berechtigungsbezeichner innerhalb der Sammlung delegierter Berechtigungen, die für eine Ressourcenanwendung definiert sind. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
isEnabled Wenn Sie eine Berechtigung erstellen oder aktualisieren, muss diese Eigenschaft auf "true" festgelegt werden (die Standardeinstellung ist). Um eine Berechtigung zu löschen, muss diese Eigenschaft zuerst auf "false" festgelegt werden. An diesem Punkt kann die Berechtigung in einem nachfolgenden Aufruf entfernt werden. bool
Typ Die möglichen Werte sind: Benutzer und Administrator. Gibt an, ob diese delegierte Berechtigung für Nicht-Administratorbenutzer als sicher angesehen werden soll, um im Namen von sich selbst zuzustimmen, oder ob eine Administratorzustimmung immer erforderlich sein sollte. Während Microsoft Graph die Standardzustimmungsanforderung für jede Berechtigung definiert, kann der Mandantenadministrator das Verhalten in seiner Organisation außer Kraft setzen (indem er die Zustimmung des Benutzers zu dieser delegierten Berechtigung zulässt, einschränkt oder beschränkt). Weitere Informationen finden Sie unter Konfigurieren der Benutzereinwilligung für Anwendungen. Zeichenfolge
userConsentDescription Eine Beschreibung der delegierten Berechtigungen, die von einem Benutzer gelesen werden soll, der die Berechtigung im eigenen Auftrag erteilt. Dieser Text wird in Zustimmungserfahrungen angezeigt, in denen der Benutzer nur im Namen von sich selbst zustimmt. Zeichenfolge
userConsentDisplayName Ein Titel für die Berechtigung, der von einem Benutzer gelesen werden soll, der die Berechtigung im eigenen Auftrag erteilt. Dieser Text wird in Zustimmungserfahrungen angezeigt, in denen der Benutzer nur im Namen von sich selbst zustimmt. Zeichenfolge
value Gibt den Wert an, der in den Scp -Anspruch (Bereich) in Zugriffstoken eingeschlossen werden soll. Darf maximal 120 Zeichen lang sein. Zulässige Zeichen sind: ! # $ % & ' ( ) * + , -. / : ; = ? @ [ ] ^ + _ { } ~ und Zeichen in den Bereichen 0-9, A-Z und a-z. Alle anderen Zeichen, einschließlich des Leerzeichens, sind nicht zulässig. Darf nicht mit .. Zeichenfolge

MicrosoftGraphPreAuthorizedApplication

Name Beschreibung Wert
appId Der eindeutige Bezeichner für die Anwendung. Zeichenfolge
delegatedPermissionIds Der eindeutige Bezeichner für die oauth2PermissionScopes, die die Anwendung erfordert. string[]

MicrosoftGraphApiApplication

Name Beschreibung Wert
acceptMappedClaims Wenn true, ermöglicht eine Anwendung die Verwendung der Anspruchszuordnung ohne Angabe eines benutzerdefinierten Signaturschlüssels. bool
knownClientApplications Wird zur Bündelung der Zustimmung verwendet, wenn Sie eine aus zwei Teilen bestehende Lösung haben (eine Client-App und eine benutzerdefinierte Web-API-App). Wenn Sie die AppID der Client-App auf diesen Wert festlegen, stimmt der Benutzer nur einmal der Client-App zu. Die Microsoft Entra-ID weiß, dass die Zustimmung zum Client die implizite Zustimmung zur Web-API bedeutet und automatisch Dienstprinzipale für beide APIs gleichzeitig bereitstellt. Die Client- und Web-API-App müssen beim selben Mandanten registriert sein. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
oauth2PermissionScopes Die Definition der delegierten Berechtigungen, die von der Web-API bereitgestellt werden, die durch diese Anwendungsregistrierung dargestellt wird. Diese delegierten Berechtigungen können von einer Clientanwendung angefordert werden und können von Benutzern oder Administratoren während der Zustimmung erteilt werden. Delegierte Berechtigungen werden manchmal als OAuth 2.0-Bereiche bezeichnet. MicrosoftGraphPermissionScope[]
preAuthorizedApplications Listet die Clientanwendungen auf, die mit den angegebenen delegierten Berechtigungen für den Zugriff auf die APIs dieser Anwendung vorautorisiert sind. Benutzer sind nicht verpflichtet, einer vorab authentifizierten Anwendung (für die angegebenen Berechtigungen) zuzustimmen. Alle anderen Berechtigungen, die nicht in preAuthorizedApplications aufgeführt sind (z. B. durch inkrementelle Zustimmung angefordert), erfordern jedoch die Zustimmung des Benutzers. MicrosoftGraphPreAuthorizedApplication[]
requestedAccessTokenVersion Gibt die von dieser Ressource erwartete Zugriffstokenversion an. Dadurch ändern sich die Version und das Format des erzeugten JWT unabhängig vom Endpunkt oder Client, der zum Anfordern des Zugriffstokens verwendet wird. Der verwendete Endpunkt, v1.0 oder v2.0, wird vom Client ausgewählt und wirkt sich nur auf die Version der ID-Token aus. Ressourcen müssen "requestedAccessTokenVersion" explizit konfigurieren, um das unterstützte Zugriffstokenformat anzugeben. Mögliche Werte für requestedAccessTokenVersion sind 1, 2 oder NULL. Wenn der Wert null ist, wird standardmäßig 1 verwendet. Dies entspricht dem v1.0-Endpunkt. Wenn signInAudience für die Anwendung als AzureADandPersonalMicrosoftAccount oder PersonalMicrosoftAccount konfiguriert ist, muss der Wert für diese Eigenschaft 2 sein. int

MicrosoftGraphAppRole

Name Beschreibung Wert
allowedMemberTypes Gibt an, ob diese App-Rolle Benutzern und Gruppen (durch Festlegen auf ['Benutzer']), anderen Anwendungen (durch Festlegen auf ['Anwendung'] oder beides (durch Festlegen auf ['Benutzer', 'Anwendung']) zugewiesen werden kann. App-Rollen, die die Zuweisung zu den Dienstprinzipalen anderer Anwendungen unterstützen, werden auch als Anwendungsberechtigungen bezeichnet. Der Wert "Anwendung" wird nur für App-Rollen unterstützt, die für Anwendungsentitäten definiert sind. string[]
Beschreibung Die Beschreibung für die App-Rolle. Dies wird angezeigt, wenn die App-Rolle zugewiesen wird und, wenn die App-Rolle als Anwendungsberechtigung fungiert, während der Zustimmungserfahrungen. Zeichenfolge
displayName Anzeigename für die Berechtigung, die in der App-Rollenzuweisung und Zustimmungserfahrung angezeigt wird. Zeichenfolge
id Eindeutiger Rollenbezeichner innerhalb der appRoles-Auflistung. Beim Erstellen einer neuen App-Rolle muss ein neuer GUID-Bezeichner bereitgestellt werden. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
isEnabled Beim Erstellen oder Aktualisieren einer App-Rolle muss dies auf "true" festgelegt werden (die Standardeinstellung). Um eine Rolle zu löschen, muss dies zuerst auf "false" festgelegt werden. An diesem Punkt kann diese Rolle in einem nachfolgenden Aufruf entfernt werden. bool
origin Gibt an, ob die App-Rolle für das Anwendungsobjekt oder für die servicePrincipal-Entität definiert ist. Darf nicht in POST- oder PATCH-Anforderungen enthalten sein. Schreibgeschützt. string (ReadOnly)
value Gibt den Wert an, der in den Rollenanspruch in ID-Token eingeschlossen werden soll, und Zugriffstoken, die einen zugewiesenen Benutzer oder Dienstprinzipal authentifizieren. Darf maximal 120 Zeichen lang sein. Zulässige Zeichen sind: ! # $ % & ' ( ) * + , -. / : ; = ? @ [ ] ^ + _ { } ~ und Zeichen in den Bereichen 0-9, A-Z und a-z. Alle anderen Zeichen, einschließlich des Leerzeichens, sind nicht zulässig. Darf nicht mit .. Zeichenfolge

MicrosoftGraphCertification

Name Beschreibung Wert
certificationDetailsUrl URL, die Zertifizierungsdetails für die Anwendung anzeigt. Zeichenfolge
certificationExpirationDateTime Der Zeitstempel, wenn die aktuelle Zertifizierung für die Anwendung abläuft. Zeichenfolge
isCertifiedByMicrosoft Gibt an, ob die Anwendung von Microsoft zertifiziert ist. bool
isPublisherAttested Gibt an, ob die Anwendung vom Anwendungsentwickler oder Herausgeber selbst bestätigt wurde. bool
lastCertificationDateTime Der Zeitstempel, zu dem die Zertifizierung für die Anwendung zuletzt hinzugefügt oder aktualisiert wurde. Zeichenfolge

MicrosoftGraphInformationalUrl

Name Beschreibung Wert
logoUrl CDN-URL zum Logo der Anwendung schreibgeschützt. string (ReadOnly)
marketingUrl Link zur Marketingseite der Anwendung. Beispiel: https://www.contoso.com/app/marketing Zeichenfolge
privacyStatementUrl Link zur Datenschutzerklärung der Anwendung. Beispiel: https://www.contoso.com/app/privacy Zeichenfolge
supportUrl Link zur Supportseite der Anwendung. Beispiel: https://www.contoso.com/app/support Zeichenfolge
termsOfServiceUrl Link zu den Nutzungsbedingungen der Anwendung. Beispiel: https://www.contoso.com/app/termsofservice Zeichenfolge

MicrosoftGraphKeyCredential

Name Beschreibung Wert
customKeyIdentifier Ein binärer 40-Zeichen-Typ, der zum Identifizieren der Anmeldeinformationen verwendet werden kann. Optional. Wenn die Nutzlast nicht angegeben wird, wird standardmäßig der Fingerabdruck des Zertifikats verwendet. Zeichenfolge
displayName Anzeigename für den Schlüssel. Optional. Zeichenfolge
endDateTime Das Datum und die Uhrzeit, zu dem die Anmeldeinformationen ablaufen. Der DateTimeOffset-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Zeichenfolge
Schlüssel Die Rohdaten des Zertifikats im Bytearray werden in base64-Zeichenfolge konvertiert. Aus einem .cer Zertifikat können Sie den Schlüssel mithilfe der Convert.ToBase64String()-Methode lesen. Weitere Informationen finden Sie unter Abrufen des Zertifikatschlüssels. Zeichenfolge
keyId Der eindeutige Bezeichner (GUID) für den Schlüssel. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
startDateTime Das Datum und die Uhrzeit, zu dem die Anmeldeinformationen gültig werden. Der Timestamp-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Zeichenfolge
Typ Der Typ der Schlüsselanmeldeinformationen; Beispiel: Symmetrische, asymmetrischeX509Cert. Zeichenfolge
Nutzung Eine Zeichenfolge, die den Zweck beschreibt, für den der Schlüssel verwendet werden kann; Beispiel: "Überprüfen". Zeichenfolge

MicrosoftGraphOptionalClaim

Name Beschreibung Wert
additionalProperties Zusätzliche Eigenschaften des Anspruchs. Wenn eine Eigenschaft in dieser Sammlung vorhanden ist, ändert sie das Verhalten des optionalen Anspruchs, der in der „name“-Eigenschaft angegeben ist. string[]
Essential Wenn der Wert „true“ ist, ist der vom Client angegebene Anspruch erforderlich, um eine reibungslose Autorisierung für die jeweilige vom Endbenutzer angeforderte Aufgabe sicherzustellen. Der Standardwert ist false. bool
name Der Name des optionalen Anspruchs. Zeichenfolge
Quelle Die Quelle (Verzeichnisobjekt) des Anspruchs. Es gibt vordefinierte Ansprüche und benutzerdefinierte Ansprüche aus Erweiterungseigenschaften. Wenn der Quellwert „null“ ist, ist der Anspruch ein vordefinierter optionaler Anspruch. Wenn der Quellwert „user“ ist, ist der Wert in der „name“-Eigenschaft die Erweiterungseigenschaft aus dem Benutzerobjekt. Zeichenfolge

MicrosoftGraphOptionalClaims

Name Beschreibung Wert
accessToken Die optionalen Ansprüche, die im JWT-Zugriffstoken zurückgegeben werden. MicrosoftGraphOptionalClaim[]
idToken Die optionalen Ansprüche, die im JWT-ID-Token zurückgegeben werden. MicrosoftGraphOptionalClaim[]
saml2Token Die optionalen Ansprüche, die im SAML-Token zurückgegeben werden. MicrosoftGraphOptionalClaim[]

MicrosoftGraphParentalControlSettings

Name Beschreibung Wert
countriesBlockedForMinors Gibt die Zwei-Buchstaben-ISO-Ländercodes an. Der Zugriff auf die Anwendung wird für Minderjährige aus den in dieser Liste angegebenen Ländern blockiert. string[]
legalAgeGroupRule Gibt die gesetzliche Altersgruppenregel an, die für Benutzer der App gilt. Kann auf einen der folgenden Werte festgelegt werden: ValueDescriptionAllowDefault. Erzwingt das gesetzliche Minimum. Dies bedeutet, dass die elterliche Zustimmung für Minderjährige in der Europäischen Union und Korea erforderlich ist.RequireConsentForPrivacyServicesEnforces der Benutzer, um das Geburtsdatum zur Einhaltung der COPPA-Regeln anzugeben. RequireConsentForMinorsRequires elterliche Zustimmung für Altersgruppen unter 18 Jahren, unabhängig von den landesspezifischen Geringfügigkeitsregeln. RequireConsentForKidsRequires elterliche Zustimmung für Altersgruppen unter 14 Jahren, unabhängig von den landesspezifischen Nebenregeln. BlockMinorsBlocks-Nebenversionen können die App verwenden. Zeichenfolge

MicrosoftGraphPasswordCredential

Name Beschreibung Wert
displayName Anzeigename für das Kennwort. Optional. Zeichenfolge
endDateTime Das Datum und die Uhrzeit, zu dem das Kennwort abläuft, wird im ISO 8601-Format dargestellt und ist immer in UTC-Zeit. Mitternacht UTC-Zeit am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Optional. Zeichenfolge
Hinweis Enthält die ersten drei Zeichen des Kennworts. Schreibgeschützt. string (ReadOnly)
keyId Der eindeutige Bezeichner für das Kennwort. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
secretText Schreibgeschützt; Enthält die von der Microsoft Entra-ID generierten starken Kennwörter, die 16 bis 64 Zeichen lang sind. Der generierte Kennwortwert wird nur während der anfänglichen POST-Anforderung zum AddPassword zurückgegeben. Es gibt keine Möglichkeit, dieses Kennwort in Zukunft abzurufen. string (ReadOnly)
startDateTime Das Datum und die Uhrzeit, zu dem das Kennwort gültig wird. Der Timestamp-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Optional. Zeichenfolge

MicrosoftGraphPublicClientApplication

Name Beschreibung Wert
redirectUris Gibt die URLs an, in denen Benutzertoken für die Anmeldung gesendet werden, oder die Umleitungs-URIs, bei denen OAuth 2.0-Autorisierungscodes und Zugriffstoken gesendet werden. string[]

MicrosoftGraphRequestSignatureVerification

Name Beschreibung Wert
allowedWeakAlgorithms Gibt an, welche schwachen Algorithmen zulässig sind. Die möglichen Werte sind: rsaSha1, unknownFutureValue. Zeichenfolge
isSignedRequestRequired Gibt an, ob signierte Authentifizierungsanforderungen für diese Anwendung erforderlich sein sollen. bool

MicrosoftGraphResourceAccess

Name Beschreibung Wert
id Der eindeutige Bezeichner einer App-Rolle oder delegierten Berechtigung, die von der Ressourcenanwendung verfügbar gemacht wird. Bei delegierten Berechtigungen sollte dies mit der ID-Eigenschaft einer der delegierten Berechtigungen in der oauth2PermissionScopes-Auflistung des Dienstprinzipals der Ressourcenanwendung übereinstimmen. Bei App-Rollen (Anwendungsberechtigungen) sollte dies mit der ID-Eigenschaft einer App-Rolle in der appRoles-Auflistung des Dienstprinzipals der Ressourcenanwendung übereinstimmen. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
Typ Gibt an, ob die ID-Eigenschaft auf eine delegierte Berechtigung oder eine App-Rolle (Anwendungsberechtigung) verweist. Mögliche Werte sind: Bereich (für delegierte Berechtigungen) oder Rolle (für App-Rollen). Zeichenfolge

MicrosoftGraphRequiredResourceAccess

Name Beschreibung Wert
resourceAccess Die Liste der OAuth2.0-Berechtigungsbereiche und App-Rollen, die die Anwendung aus der angegebenen Ressource benötigt. MicrosoftGraphResourceAccess[]
resourceAppId Der eindeutige Bezeichner für die Ressource, auf die die Anwendung zugreifen muss. Dies sollte der appId entsprechen, die in der Zielressourcenanwendung deklariert ist. Zeichenfolge

MicrosoftGraphServicePrincipalLockConfiguration

Name Beschreibung Wert
allProperties Ermöglicht das Sperren aller vertraulichen Eigenschaften. Die vertraulichen Eigenschaften sind keyCredentials, passwordCredentials und tokenEncryptionKeyId. bool
credentialsWithUsageSign Sperrt die Eigenschaften "keyCredentials" und "passwordCredentials" zur Änderung, bei der der Anmeldeinformationsnutzungstyp "Sign" lautet. bool
credentialsWithUsageVerify Sperrt die Eigenschaften "keyCredentials" und "passwordCredentials" zur Änderung, bei der der Anmeldeinformationsnutzungstyp "Überprüfen" lautet. Dadurch werden OAuth-Dienstprinzipale gesperrt. bool
isEnabled Aktiviert oder deaktiviert die Konfiguration der Dienstprinzipalsperrung. Damit die vertraulichen Eigenschaften aktualisiert werden können, aktualisieren Sie diese Eigenschaft auf "false", um die Sperre für den Dienstprinzipal zu deaktivieren. bool
tokenEncryptionKeyId Sperrt die eigenschaft tokenEncryptionKeyId zur Änderung am Dienstprinzipal. bool

MicrosoftGraphSpaApplication

Name Beschreibung Wert
redirectUris Gibt die URLs an, in denen Benutzertoken für die Anmeldung gesendet werden, oder die Umleitungs-URIs, bei denen OAuth 2.0-Autorisierungscodes und Zugriffstoken gesendet werden. string[]

MicrosoftGraphVerifiedPublisher

Name Beschreibung Wert
addedDateTime Der Zeitstempel, zu dem der überprüfte Herausgeber zum ersten Mal hinzugefügt oder zuletzt aktualisiert wurde. Zeichenfolge
displayName Der name des bestätigten Herausgebers aus dem Partner Center-Konto des App-Herausgebers. Zeichenfolge
verifiedPublisherId Die ID des überprüften Herausgebers aus dem Partner Center-Konto des App-Herausgebers. Zeichenfolge

MicrosoftGraphImplicitGrantSettings

Name Beschreibung Wert
enableAccessTokenIssuance Gibt an, ob diese Webanwendung mithilfe des impliziten OAuth 2.0-Flusses ein Zugriffstoken anfordern kann. bool
enableIdTokenIssuance Gibt an, ob diese Webanwendung mithilfe des impliziten OAuth 2.0-Flusses ein ID-Token anfordern kann. bool

MicrosoftGraphRedirectUriSettings

Name Beschreibung Wert
Index int
uri Zeichenfolge

MicrosoftGraphWebApplication

Name Beschreibung Wert
homePageUrl Startseite oder Startseite der Anwendung. Zeichenfolge
implicitGrantSettings Gibt an, ob diese Webanwendung Token mithilfe des impliziten OAuth 2.0-Flusses anfordern kann. MicrosoftGraphImplicitGrantSettings
logoutUrl Gibt die URL an, die vom Autorisierungsdienst von Microsoft verwendet wird, um einen Benutzer mithilfe von Front-Channel-, Back-Channel- oder SAML-Abmeldeprotokollen abzumelden. Zeichenfolge
redirectUris Gibt die URLs an, in denen Benutzertoken für die Anmeldung gesendet werden, oder die Umleitungs-URIs, bei denen OAuth 2.0-Autorisierungscodes und Zugriffstoken gesendet werden. string[]
redirectUriSettings MicrosoftGraphRedirectUriSettings[]