deviceTemplate-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 Eigenschaftswerte dar, die einem Satz von Geräteobjekten gemeinsam sind. Die Eigenschaften der Vorlage werden auf jedes Geräteobjekt gestempelt, das basierend auf dieser Vorlage erstellt wird. Dieses Objekt ist unveränderlich.

Erbt von directoryObject.

Methoden

Methode	Rückgabetyp	Beschreibung
List	deviceTemplate-Sammlung	Rufen Sie eine Liste der im Verzeichnis registrierten deviceTemplate-Objekte ab.
Create	deviceTemplate	Erstellen Sie eine neue Gerätevorlage , die zum Identifizieren von Attributen und zum Verwalten einer Gruppe von Geräten mit ähnlichen Merkmalen verwendet wird.
Get	deviceTemplate	Abrufen der Eigenschaften und Beziehungen eines deviceTemplate-Objekts .
Löschen	Keine	Löschen Sie eine registrierte Gerätevorlage.
Besitzer auflisten	directoryObject-Sammlung	Rufen Sie eine Liste der Besitzer für ein deviceTemplate-Objekt ab.
Besitzer hinzufügen	Keine	Fügen Sie einem deviceTemplate-Objekt einen neuen Besitzer hinzu.
Besitzer entfernen	Keine	Entfernen eines Besitzers aus einem deviceTemplate-Objekt .
Gerät aus Vorlage erstellen	device	Erstellen Sie ein neues Gerät aus einem deviceTemplate.

Eigenschaften

Eigenschaft	Typ	Beschreibung
deletedDateTime	DateTimeOffset	Datum und Uhrzeit, zu der dieses Objekt gelöscht wurde. Immer null, wenn das Objekt nicht gelöscht wurde. Geerbt von directoryObject.
deviceAuthority	Zeichenfolge	Ein vom Mandanten definierter Name für die Partei, die für die Bereitstellung und Verwaltung von Geräten auf dem Microsoft Entra-Mandanten verantwortlich ist. Beispielsweise stellt Tailwind Traders (der Hersteller) Sicherheitskameras her, die in Kundengebäuden installiert und von Lakeshore Retail (der Geräteautorität) verwaltet werden. Dieser Wert wird dem Kunden von der Gerätebehörde (Hersteller oder Händler) bereitgestellt.
id	Zeichenfolge	Eindeutiger Bezeichner für das Objekt. Geerbt von directoryObject. Schreibgeschützt. Unterstützt $filter (eq, in).
Hersteller	Zeichenfolge	Name des Herstellers.
model	Zeichenfolge	Modellname.
mutualTlsOauthConfigurationId	Zeichenfolge	Objekt-ID der mutualTlsOauthConfiguration. Dieser Wert ist nicht erforderlich, wenn selbstsignierte Zertifikate verwendet werden. Dieser Wert wird dem Kunden von der Gerätebehörde (Hersteller oder Händler) bereitgestellt.
mutualTlsOauthConfigurationTenantId	Zeichenfolge	ID (Mandanten-ID für die Geräteautorität) des Mandanten, der die mutualTlsOauthConfiguration enthält. Dieser Wert ist nicht erforderlich, wenn selbstsignierte Zertifikate verwendet werden. Dieser Wert wird dem Kunden von der Gerätebehörde (Hersteller oder Händler) bereitgestellt.
operatingSystem	Zeichenfolge	Betriebssystemtyp. Unterstützt $filter (eq, in).

Beziehungen

Beziehung	Typ	Beschreibung
deviceInstances	Gerätesammlung	Sammlung von Geräteobjekten , die auf der Grundlage dieser Vorlage erstellt wurden.
owners	directoryObject collection	Sammlung von Verzeichnisobjekten, die die Gerätevorlage und die zugehörigen deviceInstances verwalten können. Besitzer können als Dienstprinzipale, Benutzer oder Anwendungen dargestellt werden. Ein Besitzer verfügt über vollständige Berechtigungen für die Gerätevorlage und benötigt keine anderen Administratorrollen, um Geräte aus dieser Vorlage zu erstellen, zu aktualisieren oder zu löschen oder Vorlagenbesitzer hinzuzufügen oder zu entfernen. Eine Gerätevorlage kann maximal 100 Besitzer umfassen. Unterstützt $expand.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.deviceTemplate",
  "deletedDateTime": "String (timestamp)",
  "deviceAuthority": "String",
  "id": "String (identifier)",
  "manufacturer": "String",
  "model": "String",
  "mutualTlsOauthConfigurationId": "String",
  "mutualTlsOauthConfigurationTenantId": "String",
  "operatingSystem": "String"
}