servicePrincipal-Ressourcentyp

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.

Stellt eine Instanz einer Anwendung in einem Verzeichnis dar. Erbt von directoryObject.

Die agentIdentityBlueprintPrincipal-Ressource erbt von diesem Objekt.

Diese Ressource unterstützt die Verwendung einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen einer delta-Funktion. Diese Ressource ist ein offener Typ, der über die hier dokumentierten hinaus zusätzliche Eigenschaften zulässt.

Methoden

Methode Rückgabetyp Beschreibung
List servicePrincipal-Auflistung Abrufen einer Liste von servicePrincipal-Objekten.
Create servicePrincipal Erstellt ein neues servicePrincipal-Objekt.
Get servicePrincipal Dient zum Lesen der Eigenschaften und Beziehungen des servicePrincipal-Objekts.
Update Keine Aktualisieren des servicePrincipal-Objekts.
Upsert servicePrincipal Erstellen Sie einen neuen servicePrincipal, falls dieser nicht vorhanden ist, oder aktualisieren Sie die Eigenschaften eines vorhandenen servicePrincipal.
Löschen Keine Löschen des servicePrincipal-Objekts.
Get delta servicePrincipal-Auflistung Ruft inkrementelle Änderungen für Dienstprinzipale ab.
Erstellte Objekte auflisten directoryObject-Sammlung Abrufen einer createdObject-Objektauflistung.
Objekte im Besitz auflisten directoryObject collection Holen Sie sich eine ownObject-Objektsammlung.
Gelöschte Elemente
List directoryObject-Sammlung Dient zum Abrufen einer Liste von kürzlich gelöschten servicePrincipal-Objekten.
Get directoryObject Dient zum Abrufen der Eigenschaften eines kürzlich gelöschten servicePrincipal-Objekts.
Wiederherstellen directoryObject Dient zum Wiederherstellen eines kürzlich gelöschten servicePrincipal-Objekts.
Endgültig löschen Keine Dienst zum endgültigen Löschen eines servicePrincipal-Objekts.
App-Rollenzuweisungen
List appRoleAssignments appRoleAssignment-Auflistung Rufen Sie die App-Rollen ab, die diesem Dienstprinzipal zugewiesen sind.
appRoleAssignment hinzufügen appRoleAssignment Zuweisen einer App-Rolle zu diesem Dienstprinzipal.
appRoleAssignment entfernen Keine Entfernen einer App-Rollenzuweisung von diesem Dienstprinzipal.
List appRoleAssignedTo appRoleAssignment-Auflistung Abrufen der Benutzer, Gruppen und Dienstprinzipale, denen für diesen Dienstprinzipal App-Rollen zugewiesen wurden.
Add appRoleAssignedTo appRoleAssignment Zuweisen einer App-Rolle für diesen Dienstprinzipal zu einem Benutzer, einer Gruppe oder einem Dienstprinzipal.
Remove appRoleAssignedTo Keine Entfernen einer App-Rollenzuweisung für diesen Dienstprinzipal von einem Benutzer, einer Gruppe oder einem Dienstprinzipal.
Zertifikate und Geheimnisse
Add password passwordCredential Fügen Sie einem servicePrincipal ein sicheres Kennwort oder Geheimnis hinzu.
Remove password passwordCredential Entfernen eines Kennworts oder Geheimnisses aus einem servicePrincipal.
Add key keyCredential Hinzufügen von Schlüsselanmeldeinformationen zu einem Dienstprinzipal.
Remove key Keine Entfernen von Schlüsselanmeldeinformation aus einem Dienstprinzipal.
Hinzufügen eines Tokensignaturzertifikats selfSignedCertificate Fügen Sie dem Dienstprinzipal ein selbst signiertes Zertifikat hinzu. Wird hauptsächlich zum Konfigurieren von SAML-basierten SSO-Anwendungen aus dem Katalog von Microsoft Entra verwendet.
Delegierte Berechtigungsklassifizierungen
List delegatedPermissionClassification-Sammlung Rufen Sie die Berechtigungsklassifizierungen für delegierte Berechtigungen ab, die von diesem Dienstprinzipal verfügbar gemacht werden.
Add delegatedPermissionClassification Fügen Sie eine Berechtigungsklassifizierung für eine delegierte Berechtigung hinzu, die von diesem Dienstprinzipal verfügbar gemacht wird.
Remove Keine Entfernen Sie eine Berechtigungsklassifizierung für delegierte Berechtigungen, die von diesem Dienstprinzipal verfügbar gemacht wird.
Delegierte (OAuth2)-Berechtigungszuweisungen
List oAuth2PermissionGrant-Auflistung Abrufen der Gewährungen delegierter Genehmigungen, mit denen dieser Dienstprinzipal für den Zugriff auf eine API im Auftrag eines angemeldeten Benutzers autorisiert wird.
Mitgliedschaft
List memberOf directoryObject-Sammlung Ruft die Gruppen, bei denen dieser Dienstprinzipal direktes Mitglied ist, aus der memberOf-Navigationseigenschaft ab.
Auflisten transitiver Mitglieder von directoryObject-Sammlung Auflisten der Gruppen, denen dieser Dienstprinzipal angehört. Dieser Vorgang ist transitiv und schließt die Gruppen ein, in denen dieser Dienstprinzipal ein geschachteltes Mitglied.
Mitgliedergruppen prüfen String-Sammlung Sucht nach einer Mitgliedschaft in einer angegebenen Liste von Gruppen.
Überprüfen von Mitgliederobjekten String-Sammlung Überprüfen Sie auf Mitgliedschaft in einer bestimmten Liste von Gruppen, Verzeichnis-Rollen oder Verwaltungseinheitsobjekten.
Mitgliedergruppen abrufen String-Sammlung Abruf einer Liste der Gruppen, denen dieser Dienstprinzipal angehört.
Mitgliedsobjekte abrufen String collection Dient zum Abrufen der Liste der Gruppen, administrativen Einheiten und Verzeichnisrollen, in denen dieser Dienstprinzipal Mitglied ist.
Besitzer
List directoryObject collection Abrufen der Besitzer eines Dienstprinzipals.
Add directoryObject Zuweisen eines Besitzers zu einem Dienstprinzipal. Dienstprinzipalbesitzer können Benutzer oder andere Dienstprinzipale sein.
Remove Keine Entfernen eines Besitzers aus einem Dienstprinzipal. Als empfohlene bewährte Methode sollten Dienstprinzipale mindestens zwei Besitzer haben.
Anmeldeinformationen für kennwortbasiertes einmaliges Anmelden
Create passwordSingleSignOnCredentialSet Erstellen Sie ein Set von Anmeldeinformationen für den Benutzer oder die Gruppe, die im Textkörper angegeben ist.
Get passwordSingleSignOnCredentialSet Erhalten Sie ein Set von Anmeldeinformationen für den Benutzer oder die Gruppe, die im Textkörper angegeben ist.
Update Keine Aktualisieren Sie ein Set von Anmeldeinformationen für den Benutzer oder die Gruppe, die im Textkörper angegeben ist.
Löschen Keine Löschen Sie ein Set von Anmeldeinformationen für den Benutzer oder die Gruppe, die im Textkörper angegeben ist.

Eigenschaften

Wichtig

Die spezifische Verwendung von $filter und des Abfrageparameters $search wird nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual und $count festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Eigenschaft Typ Beschreibung
accountEnabled Boolesch true, wenn das Dienstprinzipalkonto aktiviert ist; andernfalls false. Wenn diese Einstellung festgelegt falseist, können sich Benutzer nicht bei dieser App anmelden, auch wenn sie ihr zugewiesen sind. Unterstützt $filter (eq, ne, not, in).
addIns addIn-Sammlung Definiert benutzerdefiniertes Verhalten, das von einem Verbraucherdienst verwendet werden kann, um eine App in bestimmten Kontexten aufzurufen. Beispielsweise können Anwendungen, die Datei-Streams rendern können, die addIns-Eigenschaft für deren "FileHandler"-Funktionalität festlegen. Dadurch können Dienste wie Microsoft 365 die Anwendung im Kontext eines Dokuments aufrufen, an dem der Benutzer arbeitet.
alternativeNames Zeichenfolgenauflistung Wird verwendet zum Abrufen von Dienstprinzipalen nach Abonnement, zur Identifizierung von Ressourcengruppen und vollständigen Ressourcen-IDs für verwaltete Identitäten. Unterstützt $filter (eq, not, ge, le, startsWith).
appDescription Zeichenfolge Die von der verknüpften Anwendung verfügbar gemachte Beschreibung.
appDisplayName Zeichenfolge Der von der verknüpften Anwendung verfügbar gemachte Anzeigename. Die maximale Länge beträgt 256 Zeichen.
appId Zeichenfolge Die eindeutige ID für die verknüpfte Anwendung (die appId-Eigenschaft). Alternativschlüssel. Unterstützt $filter (eq, ne, not, in, startsWith).
applicationTemplateId Zeichenfolge Eindeutiger Bezeichner der Anwendungsvorlage. Unterstützt $filter (eq, not, ne). Schreibgeschützt. null wenn die App nicht aus einer Anwendungsvorlage erstellt wurde.
appOwnerOrganizationId Guid Enthält die Mandanten-ID, in der die Anwendung registriert ist. Dies gilt nur für Dienstprinzipale, die von Anwendungen unterstützt werden. Unterstützt $filter (eq, ne, NOT, ge, le).
appRoleAssignmentRequired Boolesch Gibt an, ob Benutzern oder anderen Dienstprinzipalen eine App-Rollenzuweisung für diesen Dienstprinzipal erteilt werden muss, bevor Benutzer sich anmelden oder Apps Token erhalten können. Der Standardwert ist false. Lässt keine Nullwerte zu.

Unterstützt $filter (eq, ne, NOT).
appRoles appRole-Sammlung Die von der Anwendung verfügbar gemachten Rollen, die dieser Dienstprinzipal vertritt. Weitere Informationen finden Sie in der appRoles-Eigenschaftsdefinition für die Anwendungsentität . Lässt keine NULL-Werte zu.

App-Rollen und offengelegte delegierte Berechtigungsbereiche (publishedPermissionScopes) teilen sich eine Standardgrenze von 700 Berechtigungsdefinitionen pro Dienstprinzipal, einschließlich Definitionen, die von der Anwendung geerbt wurden, und Definitionen, die direkt dem Dienstprinzipal hinzugefügt wurden. Aktivierte und deaktivierte Definitionen zählen beide. Dieser Grenzwert zählt Definitionen, keine App-Rollenzuweisungen. Informationen zu Zählregeln, zum Verhalten für vorhandene Objekte über dem Grenzwert und zu Designanleitungen finden Sie unter App-Rollenlimits.
createdByAppId Zeichenfolge Die appId der Anwendung, die diesen Dienstprinzipal erstellt hat. Intern von Microsoft Entra ID festgelegt. Schreibgeschützt.
customSecurityAttributes customSecurityAttributeValue Ein offener komplexer Typ, der den Wert eines benutzerdefinierten Sicherheitsattributs enthält, das einem Verzeichnisobjekt zugewiesen ist. Lässt NULL-Werte zu.

Erfordert $select zum Abrufen. Unterstützt $filter (eq, ne, not, startsWith). Bei Filterwert wird die Groß-/Kleinschreibung beachtet.
  • Um diese Eigenschaft lesen zu können, muss der aufrufenden App die Berechtigung CustomSecAttributeAssignment.Read.All zugewiesen werden. Um diese Eigenschaft zu schreiben, muss der aufrufenden App die Berechtigung "CustomSecAttributeAssignment.ReadWrite.All" zugewiesen werden.
  • Um diese Eigenschaft in delegierten Szenarien lesen oder schreiben zu können, muss dem Administrator die Rolle des Attributzuweisungsadministrators zugewiesen werden.
deletedDateTime DateTimeOffset Datum und Uhrzeit, zu denen der Dienstprinzipal gelöscht wurde. Schreibgeschützt.
description String Freies Textfeld zur Eingabe einer internen Beschreibung für Endbenutzer des Dienstprinzipals. Endbenutzerportale wie MyApps zeigen die Anwendungsbeschreibung in diesem Feld an. Die maximal zulässige Größe beträgt 1.024 Zeichen. Unterstützt $filter (eq, ne, not, ge, le, startsWith) und $search.
disabledByMicrosoftStatus Zeichenfolge Gibt an, ob Microsoft die registrierte Anwendung deaktiviert hat. Die möglichen Werte sind: null (Standardwert), NotDisabledund DisabledDueToViolationOfServicesAgreement (Gründe können verdächtige, missbräuchliche oder böswillige Aktivitäten oder ein Verstoß gegen den Microsoft-Servicevertrag sein).

Unterstützt $filter (eq, ne, not).
displayName Zeichenfolge Der Anzeigename für den Dienstprinzipal. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte), $search und $orderby.
errorUrl Zeichenfolge Veraltet. Nicht verwenden.
homepage Zeichenfolge Startseite der Anwendung.
id Zeichenfolge Der eindeutige Bezeichner für den Dienstprinzipal. Geerbt von directoryObject. Key. Lässt keine Nullwerte zu. Schreibgeschützt. Unterstützt $filter (eq, ne, not, in).
info informationalUrl Grundlegende Profilinformationen der erhaltenen Anwendung, wie z. B. die URLs für Marketing, Support, Nutzungsbedingungen und Datenschutzerklärung der App. Die Nutzungsbedingungen und Datenschutzbestimmungen werden auf der Oberfläche für die Benutzerzustimmung angezeigt. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Nutzungsbedingungen und Datenschutzbestimmungen für registrierte Microsoft Entra-Apps.

Unterstützt $filter (eq, ne, not, ge, le und eq für null-Werte).
isDisabled Boolean Gibt an, ob der Dienstprinzipal der App in einem Mandanten oder mandantenübergreifend für mehrinstanzenfähige Apps neue Zugriffstoken abrufen oder auf geschützte Ressourcen zugreifen kann. Wenn festgelegt auf true, bleiben vorhandene Token gültig, bis sie basierend auf ihrer konfigurierten Lebensdauer ablaufen und die App in der Liste der Unternehmens-Apps sichtbar bleibt, aber Benutzer können sich nicht anmelden.true wenn die Anwendung deaktiviert (deaktiviert) ist, andernfalls false.
keyCredentials keyCredential-Auflistung Die Auflistung der wichtigsten Anmeldeinformationen, die mit dem Dienstprinzipal verknüpft sind. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, not, ge, le).
loginUrl Zeichenfolge Gibt die URL an, unter der der Dienstanbieter den Benutzer zur Authentifizierung an Microsoft Entra ID umleitet. Microsoft Entra ID verwendet die URL, um die Anwendung von Microsoft 365 oder dem Microsoft Entra Meine Apps aus zu starten. Wenn leer, führt Microsoft Entra ID eine vom IdP initiierte Anmeldung für Anwendungen durch, die mit SAML-basiertem einmaligem Anmelden konfiguriert sind. Der Benutzer startet die Anwendung über Microsoft 365, den Microsoft Entra Meine Apps oder die Microsoft Entra SSO-URL.
logoutUrl Zeichenfolge Gibt die URL an, die der Autorisierungsdienst von Microsoft verwendet, um einen Benutzer mit OpenId Connect-Front-Channel-, Rückkanal- oder SAML-Abmeldeprotokollen abzumelden.
notes String Freies Textfeld zum Erfassen von Informationen zum Dienstprinzipal, das normalerweise für betriebliche Zwecke verwendet wird. Die maximal zulässige Größe beträgt 1.024 Zeichen.
notificationEmailAddresses Zeichenfolgenauflistung Gibt die Liste der E-Mail-Adressen an, an die Microsoft Entra ID eine Benachrichtigung sendet, wenn das Ablaufdatum des aktiven Zertifikats näher rückt. Dies gilt nur für die Zertifikate, die zum Signieren des SAML-Tokens verwendet werden, das für Microsoft Entra Kataloganwendungen ausgestellt wurde.
passwordCredentials passwordCredential-Auflistung Die Auflistung der Kennwortanmeldeinformationen, die mit dem Dienstprinzipal verknüpft sind. Lässt keine NULL-Werte zu.
passwordSingleSignOnSettings passwordSingleSignOnSettings Die Auflistung für Einstellungen im Zusammenhang mit der kennwortbasierten einmaligen Anmeldung. Verwenden Sie $select=passwordSingleSignOnSettings zum Lesen der Eigenschaft. Schreibgeschützt für applicationTemplates mit Ausnahme von benutzerdefinierten „applicationTemplates“.
preferredSingleSignOnMode Zeichenfolge Gibt den Modus für einmaliges Anmelden an, der für diese Anwendung konfiguriert ist. Microsoft Entra ID verwendet den bevorzugten Single Sign-On-Modus, um die Anwendung von Microsoft 365 oder dem Microsoft Entra Meine Apps aus zu starten. Unterstützte Werte sind: password, saml, notSupported und oidc. Hinweis: Dieses Feld kann für ältere SAML-Apps und für OIDC-Anwendungen bestimmt null werden, bei denen es nicht automatisch festgelegt wird.
permissionGrantPreApprovalPolicies permissionGrantPreApprovalPolicy collection Die Liste der Vorabgenehmigungsrichtlinien, die dem Dienstprinzipal zugewiesen wurde.
preferredTokenSigningKeyEndDateTime DateTimeOffset Gibt das Ablaufdatum für die „keyCredentials“ an, die für die Tokensignatur verwendet werden, gekennzeichnet durch preferredTokenSigningKeyThumbprint. Die Aktualisierung dieses Attributs wird derzeit nicht unterstützt. Weitere Informationen finden Sie unter ServicePrincipal-Eigenschaftenunterschiede.
preferredTokenSigningKeyThumbprint Zeichenfolge Diese Eigenschaft kann für SAML-Anwendungen verwendet werden (Apps, bei denen preferredSingleSignOnModesamlauf festgelegt ist), um zu steuern, welches Zertifikat zum Signieren der SAML-Antworten verwendet wird. Schreiben Sie für Anwendungen, die keine SAML sind, nicht auf diese Eigenschaft, oder verlassen Sie sich nicht anderweitig auf sie.
publishedPermissionScopes permissionScope-Sammlung Die von der Anwendung zur Verfügung gestellten delegierten Berechtigungen. Weitere Informationen finden Sie unter der Eigenschaft oauth2PermissionScopes in der API-Eigenschaft der Anwendungsentität. Lässt keine NULL-Werte zu.
Hinweis: Diese Eigenschaft heißt oauth2PermissionScopes in v1.0.

Diese Bereiche und AppRoles teilen sich ein Standardlimit von 700 Berechtigungsdefinitionen pro Dienstprinzipal. Aktivierte und deaktivierte Definitionen zählen beide. Informationen zu Zählregeln, zum Verhalten für vorhandene Objekte über dem Grenzwert und zu Designanleitungen finden Sie unter App-Rollenlimits.
publisherName Zeichenfolge Der Name des Microsoft Entra-Mandanten, der die Anwendung veröffentlicht hat.
replyUrls Zeichenfolgenauflistung Die URLs, an die Benutzertoken zur Anmeldung bei der verknüpften Anwendung gesendet werden, oder die Umleitungs-URIs, an die die OAuth 2.0-Autorisierungscodes und Zugriffstoken für die verknüpfte Anwendung gesendet werden. Lässt keine Nullwerte zu.
samlMetadataUrl Zeichenfolge Die URL, unter der der Dienst SAML-Metadaten für den Verbund verfügbar macht.
samlSingleSignOnSettings samlSingleSignOnSettings Die Sammlung für Einstellungen im Zusammenhang mit der einmaligen SAML-Anmeldung.
servicePrincipalNames Zeichenfolgenauflistung Enthält die Liste der identifiersUris-, die aus der zugehörigen Anwendung kopiert werden. Hybridanwendungen können weitere Werte hinzugefügt werden. Diese Werte können verwendet werden, um die Berechtigungen zu identifizieren, die von dieser App innerhalb von Microsoft Entra ID verfügbar gemacht werden. Beispiel:
  • Client-Apps können einen Ressourcen-URI angeben, der auf den Werten dieser Eigenschaft basiert, um ein Zugriffstoken abzurufen, bei dem es sich um den URI handelt, der im "aud"-Anspruch zurückgegeben wird.

Der "any"-Operator ist für Filterausdrücke für mehrwertige Eigenschaften erforderlich. Lässt keine NULL-Werte zu.

Unterstützt $filter (eq, not, ge, le, startsWith).
servicePrincipalType Zeichenfolge Gibt an, ob der Dienstprinzipal eine Anwendung oder eine verwaltete Identität darstellt. Diese Eigenschaft wird von Microsoft Entra ID intern festgelegt.
  • Für einen Dienstprinzipal, der eine Anwendung darstellt, wird dies als Applicationfestgelegt.
  • Für einen Dienstprinzipal, der eine verwaltete Identität darstellt, wird dies als ManagedIdentityfestgelegt.
  • Für einen Dienstprinzipal, der eine Agentidentität darstellt, ist dies auf ServiceIdentityfestgelegt.
  • Der SocialIdp Typ ist für den internen Gebrauch bestimmt.
signInAudience Zeichenfolge Gibt die Microsoft-Konten an, die für die aktuelle Anwendung unterstützt werden. Schreibgeschützt.

Unterstützte Werte:
  • AzureADMyOrg: Benutzer mit einem Microsoft-Geschäfts-, Schul- oder Unikonto im Microsoft Entra-Mandanten (einzelner Mandant) meiner organization.
  • AzureADMultipleOrgs: Benutzer mit einem Microsoft-Geschäfts-, Schul- oder Unikonto im Microsoft Entra-Mandanten (mehrere Mandanten) einer organization.
  • AzureADandPersonalMicrosoftAccount: Benutzer mit einem persönlichen Microsoft-Konto oder einem Geschäfts- oder Schulkonto im Microsoft Entra-Mandanten einer beliebigen organization.
  • PersonalMicrosoftAccount: Nur Benutzer mit einem persönlichen Microsoft-Konto.
tags String-Sammlung Benutzerdefinierte Zeichenfolgen, die zum Kategorisieren und Identifizieren des Dienstprinzipals verwendet werden können. Lässt keine Nullwerte zu. Der Wert ist die Vereinigung von Zeichenfolgen, die hier und in der Tags-Eigenschaft der zugeordneten Anwendungsentität festgelegt sind.

Unterstützt $filter (eq, not, ge, le, startsWith).
tokenEncryptionKeyId Zeichenfolge Gibt die keyId eines öffentlichen Schlüssels aus der keyCredentials-Sammlung an. Wenn konfiguriert, gibt Microsoft Entra ID Token für diese Anwendung aus, die mit dem durch diese Eigenschaft angegebenen Schlüssel verschlüsselt sind. Der Anwendungscode, der das verschlüsselte Token erhält, muss das Token mit dem zugehörigen privaten Schlüssel entschlüsseln, bevor es für den angemeldeten Benutzer verwendet werden kann.
verifiedPublisher verifiedPublisher Gibt den überprüften Herausgeber der Anwendung an, die mit diesem Dienstprinzipal verknüpft ist.

Beziehungen

Wichtig

Die spezifische Verwendung des $filter Abfrageparameters wird nur unterstützt, wenn Sie den ConsistencyLevel-Header auf eventual und $countverwenden. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Beziehung Typ Beschreibung
appManagementPolicies appManagementPolicy-Sammlung Die auf diesen Dienstprinzipal angewendete appManagementPolicy.
appRoleAssignedTo appRoleAssignment App-Rollenzuweisungen für diese App oder diesen Dienst, die Benutzern, Gruppen und anderen Dienstprinzipalen gewährt werden. Unterstützt $expand.
appRoleAssignments appRoleAssignment-Auflistung App-Rollenzuweisung für eine andere App oder einen anderen Dienst, die diesem Dienstprinzipal gewährt wird. Unterstützt $expand.
claimsMappingPolicies claimsMappingPolicy-Sammlung Die diesem Dienstprinzipal zugewiesenen claimsMappingPolicies. Unterstützt $expand.
claimsPolicy customClaimsPolicy Eine Anspruchsrichtlinie, die es Anwendungsadministratoren ermöglicht, die Ansprüche anzupassen, die in Token ausgegeben werden, die von dieser Richtlinie betroffen sind.
createdObjects directoryObject-Sammlung Verzeichnisobjekte, die von diesem Dienstprinzipal erstellt werden. Schreibgeschützt. Lässt Nullwerte zu.
delegatedPermissionClassifications delegatedPermissionClassification-Sammlung Die Berechtigungsklassifizierungen für delegierte Berechtigungen, verfügbar gemacht von der App, die dieser Dienstprinzipal darstellt. Unterstützt $expand.
endpoints endpoint-Sammlung Zur Ermittlung verfügbare Endpunkte. Dienste wie SharePoint füllen diese Eigenschaft mit mandantenspezifischen SharePoint-Endpunkten, die von anderen Anwendungen erkannt und verwendet werden können.
homeRealmDiscoveryPolicies homeRealmDiscoveryPolicy-Sammlung Die diesem Dienstprinzipal zugewiesenen homeRealmDiscoveryPolicies. Unterstützt $expand.
memberOf directoryObject-Sammlung Rollen, denen dieser Dienstprinzipal angehört. HTTP-Methoden: GET; schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
oauth2PermissionGrants oAuth2PermissionGrant-Auflistung Delegierte Berechtigungen, die diesen Dienstprinzipal für den Zugriff auf eine API im Auftrag eines angemeldeten Benutzers autorisieren. Schreibgeschützt. Lässt NULL-Werte zu.
ownedObjects directoryObject-Sammlung Verzeichnisobjekte, die im Besitz dieses Dienstprinzipals sind. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand und $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
owners directoryObject-Sammlung Verzeichnisobjekte, die Besitzer dieses Dienstprinzipals sind. Die Besitzer sind eine Gruppe von Nicht-Admin-Benutzern oder servicePrincipals, die dieses Objekt ändern dürfen. Unterstützt $expand und $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
remoteDesktopSecurityConfiguration remoteDesktopSecurityConfiguration Das remoteDesktopSecurityConfiguration-Objekt, das auf diesen Dienstprinzipal angewendet wird. Unterstützt $filter (eq) für die isRemoteDesktopProtocolEnabled-Eigenschaft .
Synchronisation Synchronisierung Stellt die Funktion zur Microsoft Entra-Identitätssynchronisierung über die Microsoft Graph-API dar.
tokenIssuancePolicies tokenIssuancePolicy-Sammlung Die diesem Dienstprinzipal zugewiesenen tokenIssuancePolicies. Unterstützt $expand.
tokenLifetimePolicies tokenLifetimePolicy-Sammlung Die diesem Dienstprinzipal zugewiesenen tokenLifetimePolicies. Unterstützt $expand.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "accountEnabled": true,
  "addIns": [{"@odata.type": "microsoft.graph.addIn"}],
  "alternativeNames": "String",
  "appDisplayName": "String",
  "appId": "String",
  "appOwnerOrganizationId": "Guid",
  "applicationTemplateId": "String",
  "appRoleAssignmentRequired": true,
  "appRoles": [{"@odata.type": "microsoft.graph.appRole"}],
  "createdByAppId": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "disabledByMicrosoftStatus": "String",
  "displayName": "String",
  "errorUrl": "String",
  "homepage": "String",
  "id": "String (identifier)",
  "info": {"@odata.type": "microsoft.graph.informationalUrl"},
  "isDisabled": "Boolean",
  "keyCredentials": [{"@odata.type": "microsoft.graph.keyCredential"}],
  "loginUrl": "String",
  "logoutUrl": "String",
  "notes": "String",
  "notificationEmailAddresses": ["String"],
  "publishedPermissionScopes": [{"@odata.type": "microsoft.graph.permissionScope"}],
  "passwordCredentials": [{"@odata.type": "microsoft.graph.passwordCredential"}],
  "passwordSingleSignOnSettings": {"@odata.type": "microsoft.graph.passwordSingleSignOnSettings"},
  "preferredSingleSignOnMode": "String",
  "preferredTokenSigningKeyEndDateTime": "DateTime",
  "preferredTokenSigningKeyThumbprint": "String",
  "publisherName": "String",
  "replyUrls": ["String"],
  "samlMetadataUrl": "String",
  "samlSingleSignOnSettings": "microsoft.DirectoryServices.SamlSingleSignOnSettings",
  "servicePrincipalNames": ["String"],
  "servicePrincipalType": "String",
  "signInAudience": "String",
  "tags": ["String"],
  "tokenEncryptionKeyId": "String",
  "verifiedPublisher": {"@odata.type": "microsoft.graph.verifiedPublisher"}
}
  • Last updated on