Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Stellt die anpassbare Nutzungsbedingungen eines Mandanten dar, die mit Microsoft Entra ID Governance erstellt und verwaltet wird. Sie können die folgenden Methoden verwenden, um das Feature Microsoft Entra Nutzungsbedingungen entsprechend Ihrem Szenario zu erstellen und zu verwalten.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | Vereinbarungssammlung | Ruft eine Objektauflistung für Vereinbarungen ab. |
| Create | Verträge | Erstellen Sie eine neue Vereinbarung, indem Sie in der Vertragssammlung veröffentlichen. |
| Get | Verträge | Liest Eigenschaften und Beziehungen eines Vereinbarungsobjekts. |
| Update | Keine | Aktualisieren eines Vereinbarungsobjekts. |
| Delete | Keine | Löschen sie ein Vereinbarungsobjekt. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| displayName | String | Anzeigename der Vereinbarung. Der Anzeigename wird für die interne Nachverfolgung der Vereinbarung verwendet, endbenutzern, die die Vereinbarung anzeigen, jedoch nicht angezeigt. Unterstützt $filter (eq). |
| id | String | Der Bezeichner der Vereinbarung. Schreibgeschützt. Unterstützt $filter (eq). |
| isPerDeviceAcceptanceRequired | Boolesch | Gibt an, ob Endbenutzer diese Vereinbarung auf jedem Gerät akzeptieren müssen, von dem aus sie darauf zugreifen. Der Endbenutzer muss sein Gerät in Microsoft Entra ID registrieren, sofern noch nicht geschehen. Unterstützt $filter (eq). |
| isViewingBeforeAcceptanceRequired | Boolesch | Gibt an, ob der Benutzer die Vereinbarung erweitern muss, bevor er akzeptiert. Unterstützt $filter (eq). |
| termsExpiration | termsExpiration | Ablaufzeitplan und Häufigkeit der Vereinbarung für alle Benutzer. Unterstützt $filter (eq). |
| userReacceptRequiredFrequency | Dauer | Die Dauer, nach der der Benutzer die Nutzungsbedingungen erneut akzeptieren muss. Der Wert wird für die Dauer im ISO 8601-Format dargestellt. Unterstützt $filter (eq). |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Akzepte | agreementAcceptance-Sammlung | Schreibgeschützt. Informationen über die Annahmen dieser Vereinbarung. |
| file | agreementFile | Standard-PDF, die mit dieser Vereinbarung verknüpft ist. |
| files | agreementFileLocalization-Auflistung | PDFs, die mit dieser Vereinbarung verknüpft sind. Diese Eigenschaft wird derzeit als veraltet gekennzeichnet. Verwenden Sie stattdessen die Dateieigenschaft . Unterstützt $expand. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.agreement",
"displayName": "String",
"id": "String (identifier)",
"isPerDeviceAcceptanceRequired": "Boolean",
"isViewingBeforeAcceptanceRequired": "Boolean",
"termsExpiration": {
"@odata.type": "microsoft.graph.termsExpiration"
},
"userReacceptRequiredFrequency": "String (duration)"
}