accessReviewScheduleDefinition-Ressourcentyp

Namespace: microsoft.graph

Stellt die Planung einer Azure AD-Zugriffsüberprüfung dar.

Eine accessReviewScheduleDefinition enthält eine Liste der accessReviewInstance-Objekte . Jede Serie der Terminplandefinition erstellt eine Instanz. Instanzen stellen auch jede eindeutige Ressource dar, die überprüft wird. Wenn eine Terminplandefinition mehrere Ressourcen überprüft, verfügt jede Ressource über eine eindeutige Instanz pro Serie. Im Falle einer einmaligen Überprüfung wird pro Ressource nur eine Instanz erstellt.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
accessReviewScheduleDefinitions auflisten	accessReviewScheduleDefinition-Sammlung	Listet jede accessReviewScheduleDefinition auf. Schließt keine zugeordneten accessReviewInstance-Objekte in die Ergebnisse ein.
accessReviewScheduleDefinition abrufen	accessReviewScheduleDefinition	Rufen Sie eine accessReviewScheduleDefinition mit einer angegebenen ID ab. Schließt keine zugeordneten accessReviewInstance-Objekte in die Ergebnisse ein.
accessReviewScheduleDefinition erstellen	accessReviewScheduleDefinition	Erstellen Sie eine neue accessReviewScheduleDefinition.
accessReviewScheduleDefinition löschen	Keine.	Löschen Sie eine accessReviewScheduleDefinition mit einer angegebenen ID.
accessReviewScheduleDefinition aktualisieren	Keine.	Dient zum Aktualisieren der Eigenschaften eines accessReviewScheduleDefinition-Objekts mit einer angegebenen ID.
filterByCurrentUser	accessReviewScheduleDefinition-Sammlung	Ruft alle Definitionen ab, für die der aufrufende Benutzer ein Prüfer für eine oder mehrere Instanzen ist.

Eigenschaften

Eigenschaft	Typ	Beschreibung
additionalNotificationRecipients	accessReviewNotificationRecipientItem-Sammlung	Definiert die Liste der zusätzlichen Benutzer oder Gruppenmitglieder, die über den Status der Zugriffsüberprüfung benachrichtigt werden sollen.
createdBy	userIdentity	Benutzer, der diese Rezension erstellt hat. Schreibgeschützt.
createdDateTime	DateTimeOffset	Zeitstempel, als die Zugriffsüberprüfungsreihe erstellt wurde. Unterstützt $select und $orderBy. Schreibgeschützt.
descriptionForAdmins	Zeichenfolge	Beschreibung, die von den Erstellern der Überprüfung bereitgestellt wird, um Administratoren mehr Kontext der Überprüfung bereitzustellen. Unterstützt $select.
descriptionForReviewers	Zeichenfolge	Beschreibung, die von den Erstellern der Rezension bereitgestellt wird, um bearbeitern mehr Kontext der Rezension bereitzustellen. Prüfern wird diese Beschreibung in der E-Mail angezeigt, die an sie gesendet wurde, um ihre Überprüfung anzufordern. E-Mail-Benachrichtigungen unterstützen bis zu 256 Zeichen. Unterstützt $select.
displayName	Zeichenfolge	Name der Zugriffsüberprüfungsreihe. Unterstützt $select und $orderBy. Beim Erstellen erforderlich.
fallbackReviewers	accessReviewReviewerScope-Auflistung	Diese Sammlung von Bearbeiterbereichen wird verwendet, um die Liste der Fallbackprüfer zu definieren. Diese Fallbackprüfer werden benachrichtigt, um Maßnahmen zu ergreifen, wenn keine Benutzer aus der angegebenen Liste der Prüfer gefunden werden. Dies kann auftreten, wenn entweder der Gruppenbesitzer als Prüfer angegeben ist, der Gruppenbesitzer jedoch nicht vorhanden ist, oder der Manager als Prüfer angegeben wird, aber der Vorgesetzte eines Benutzers nicht vorhanden ist. Siehe accessReviewReviewerScope. Ersetzt backupReviewers. Unterstützt $select.
id	Zeichenfolge	Der mit dem Feature zugewiesene eindeutige Bezeichner einer Zugriffsüberprüfung. Unterstützt $select. Schreibgeschützt.
instanceEnumerationScope	accessReviewScope	Diese Eigenschaft ist erforderlich, wenn eine Überprüfung für den Zugriff von Gastbenutzern in allen Microsoft 365-Gruppen definiert wird und bestimmt, welche Microsoft 365-Gruppen überprüft werden. Jede Gruppe wird zu einer eindeutigen accessReviewInstance der Zugriffsüberprüfungsreihe. Unterstützte Bereiche finden Sie unter accessReviewScope. Unterstützt $select. Beispiele für Optionen zum Konfigurieren von instanceEnumerationScope finden Sie unter Konfigurieren des Umfangs Ihrer Zugriffsüberprüfungsdefinition mithilfe der Microsoft Graph-API.
lastModifiedDateTime	DateTimeOffset	Zeitstempel, als die Zugriffsüberprüfungsreihe zuletzt geändert wurde. Unterstützt $select. Schreibgeschützt.
Bewertungen	accessReviewReviewerScope-Auflistung	Diese Sammlung von Zugriffsüberprüfungsbereichen wird verwendet, um zu definieren, wer die Prüfer sind. Die Bearbeitereigenschaft ist nur aktualisierbar, wenn einzelne Benutzer als Prüfer zugewiesen werden. Beim Erstellen erforderlich. Unterstützt $select. Beispiele für Optionen zum Zuweisen von Bearbeitern finden Sie unter Zuweisen von Prüfern zu Ihrer Zugriffsüberprüfungsdefinition mithilfe der Microsoft Graph-API.
Bereich	accessReviewScope	Definiert die Entitäten, deren Zugriff überprüft wird. Unterstützte Bereiche finden Sie unter accessReviewScope. Beim Erstellen erforderlich. Unterstützt $select und $filter (contains nur). Beispiele für Optionen zum Konfigurieren des Bereichs finden Sie unter Konfigurieren des Umfangs Ihrer Zugriffsüberprüfungsdefinition mithilfe der Microsoft Graph-API.
settings	accessReviewScheduleSettings	Die Einstellungen für eine Zugriffsüberprüfungsreihe finden Sie unten in der Typdefinition. Unterstützt $select. Beim Erstellen erforderlich.
status	Zeichenfolge	Dieses schreibgeschützte Feld gibt den Status einer Zugriffsüberprüfung an. Die typischen Zustände umfassen Initializing, NotStarted, Starting, InProgress, Completing, AutoReviewing``Completedund AutoReviewed. Unterstützt $select, $orderbyund $filter (eq nur). Schreibgeschützt.
backupReviewers (veraltet)	accessReviewReviewerScope-Auflistung	Diese Sammlung von Bearbeiterbereichen wird verwendet, um die Liste der Fallbackprüfer zu definieren. Diese Fallbackprüfer werden benachrichtigt, um Maßnahmen zu ergreifen, wenn keine Benutzer aus der angegebenen Liste der Prüfer gefunden werden. Dies kann auftreten, wenn entweder der Gruppenbesitzer als Prüfer angegeben ist, der Gruppenbesitzer jedoch nicht vorhanden ist, oder der Manager als Prüfer angegeben wird, aber der Vorgesetzte eines Benutzers nicht vorhanden ist. Unterstützt $select. Hinweis: Diese Eigenschaft wurde durch fallbackReviewers ersetzt. Wenn Sie jedoch entweder "backupReviewers " oder "fallbackReviewers " angeben, werden die gleichen Werte automatisch in die andere Eigenschaft aufgefüllt.

Beziehungen

Beziehung	Typ	Beschreibung
instances	accessReviewInstance-Sammlung	Wenn accessReviewScheduleDefinition eine wiederkehrende Zugriffsprüfung ist, stellen Instanzen jede Serie dar. Eine Überprüfung, die nicht wiederholt wird, weist genau eine Instanz auf. Instanzen stellen auch jede eindeutige Ressource dar, die in accessReviewScheduleDefinition überprüft wird. Wenn eine Überprüfung über mehrere Ressourcen und mehrere Instanzen verfügt, verfügt jede Ressource über eine eindeutige Instanz für jede Serie.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.accessReviewScheduleDefinition",
  "id": "String (identifier)",
  "displayName": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "status": "String",
  "descriptionForAdmins": "String",
  "descriptionForReviewers": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "instanceEnumerationScope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "settings": {
    "@odata.type": "microsoft.graph.accessReviewScheduleSettings"
  },
  "additionalNotificationRecipients": [
    {
        "@odata.type": "microsoft.graph.accessReviewNotificationRecipientItem"
    }
  ]
}