type de ressource devicedevice resource type

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Représente un appareil enregistré dans l’annuaire.Represents a device registered in the directory. Les appareils sont créés dans le cloud via le Service d’inscription pour appareils ou via Intune.Devices are created in the cloud using the Device Registration Service or by Intune. Ils sont utilisés par les stratégies d’accès conditionnel pour l’authentification multifacteur.They're used by conditional access policies for multi-factor authentication. Ces appareils peuvent être des ordinateurs de bureau, des ordinateurs portables, des téléphones et des tablettes.These devices can range from desktop and laptop machines to phones and tablets. Hérite de directoryObject.Inherits from directoryObject.

Cette ressource vous permet d’ajouter vos propres données à des propriétés personnalisées à l’aide des extensions.This resource lets you add your own data to custom properties using extensions.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Obtenir un appareilGet device devicedevice Lire les propriétés et les relations de l’objet appareil.Read properties and relationships of device object.
Répertorier les appareilsList devices collection devicedevice collection Récupérez une liste des appareils enregistrés dans le répertoire.Retrieve a list of devices registered in the directory.
Mettre à jour un appareilUpdate device devicedevice Mettez à jour les propriétés de l’objet périphérique.Update the properties of the device object.
Supprimez l’appareilDelete device AucunNone Supprimez l’objet Device.Delete the device object.
Répertorier memberOfList memberOf collection directoryObjectdirectoryObject collection Répertoriez les groupes dont l’appareil est membre direct.List the groups that the device is a direct member of.
Liste des objets membresOf transitifsList transitive memberOf collection directoryObjectdirectoryObject collection Répertoriez les groupes dont l’appareil est membre.List the groups that the device is a member of. Cette opération est transitive.This operation is transitive.
Répertorier registeredOwnersList registeredOwners collection directoryObjectdirectoryObject collection Obtenez les utilisateurs qui sont des propriétaires inscrits de l’appareil de la propriété de navigation registeredOwners.Get the users that are registered owners of the device from the registeredOwners navigation property.
Répertorier registeredUsersList registeredUsers collection directoryObjectdirectoryObject collection Obtenez les utilisateurs inscrits de l’appareil de la propriété de navigation registeredUsers.Get the registered users of the device from the registeredUsers navigation property.
checkMemberObjectscheckMemberObjects Collection de chaînesString collection Vérifiez l'appartenance à une liste d'objets de groupe, de rôle d'annuaire ou d'unité administrative.Check for membership in a list of group, directory role, or administrative unit objects.
Extensions d’ouvertureOpen extensions
Créer une extension d’ouvertureCreate open extension openTypeExtensionopenTypeExtension Créer une extension d’ouverture et ajouter des propriétés personnalisées dans une ressource nouvelle ou existante.Create an open extension and add custom properties to a new or existing resource.
Obtenir une extension d’ouvertureGet open extension collection openTypeExtensionopenTypeExtension collection Obtenir une extension d’ouverture identifiée par le nom de l’extension.Get an open extension identified by the extension name.
Extensions de schémaSchema extensions
Ajouter des valeurs d’extension de schémaAdd schema extension values Créer une définition d’extension de schéma, puis l’utiliser pour ajouter des données personnalisées à une ressource.Create a schema extension definition and then use it to add custom typed data to a resource.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
accountEnabledaccountEnabled BooleanBoolean valeur true si le compte est activé ; sinon, valeur false.true if the account is enabled; otherwise, false. la valeur par défaut est true.default is true.
alternativeSecurityIdsalternativeSecurityIds collection alternativeSecurityIdalternativeSecurityId collection Réservé à un usage interneFor internal use only. Ne peut pas avoir la valeur Null.Not nullable.
approximateLastSignInDateTimeapproximateLastSignInDateTime DateTimeOffsetDateTimeOffset Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC.The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. En lecture seule.Read-only.
complianceExpirationDateTimecomplianceExpirationDateTime DateTimeOffsetDateTimeOffset Horodatage lorsque le périphérique n’est plus considéré comme conforme.The timestamp when the device is no longer deemed compliant. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC.The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. En lecture seule.Read-only.
deviceIddeviceId GuidGuid Identificateur unique défini par le Service d’inscription Azure pour appareils au moment de l’inscription.Unique identifier set by Azure Device Registration Service at the time of registration.
deviceMetadatadeviceMetadata StringString Réservé à un usage interneFor internal use only. Défini sur Null.Set to null.
deviceVersiondeviceVersion Int32Int32 À usage interne uniquement.For internal use only.
displayNamedisplayName StringString Nom d’affichage de l’appareil. Obligatoire.The display name for the device. Required.
idid StringString Identificateur unique de l’appareil. Hérité de directoryObject. Clé, ne peut pas avoir la valeur Null. En lecture seule.The unique identifier for the device. Inherited from directoryObject. Key, Not nullable. Read-only.
isCompliantisCompliant BooléenBoolean true si l’appareil est conforme aux stratégies de gestion des périphériques mobiles (GPM) ; sinon, false.true if the device complies with Mobile Device Management (MDM) policies; otherwise, false. En lecture seule.Read-only. Ceci peut uniquement être mis à jour par Intune pour tout type de système d’exploitation d’appareil ou par une application MDM approuvée pour les périphériques du système d’exploitation Windows.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
isManagedisManaged BooléenBoolean true si l’appareil est géré par une application de gestion des périphériques mobiles (GPM) ; sinon, false.true if the device is managed by a Mobile Device Management (MDM) app; otherwise, false. Ceci peut uniquement être mis à jour par Intune pour tout type de système d’exploitation d’appareil ou par une application MDM approuvée pour les périphériques du système d’exploitation Windows.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
Fabricantmanufacturer StringString Fabricant de l’appareil.Manufacturer of the device. En lecture seule.Read-only.
mdmAppIdmdmAppId StringString Identificateur d’application utilisé pour enregistrer l’appareil dans MDM.Application identifier used to register device into MDM.

En lecture seule.Read-only. Prend en charge $filter.Supports $filter.
modèlemodel StringString Modèle de l’appareil.Model of the device. En lecture seule.Read-only.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset Heure de dernière synchronisation de l’objet avec le répertoire local. Le type Timestamp représente les informations de date et d’heure à l’aide du format ISO 8601 et est toujours en heure UTC.The last time at which the object was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : '2014-01-01T00:00:00Z'. En lecture seule.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean true si cet objet est synchronisé à partir d’un répertoire local ; false si cet objet a été initialement synchronisé à partir d’un répertoire local, mais n’est plus synchronisé ; null si cet objet n’a jamais été synchronisé à partir d’un répertoire local (valeur par défaut).true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). En lecture seule.Read-only.
operatingSystemoperatingSystem ChaîneString Type de système d’exploitation sur l’appareil. Obligatoire.The type of operating system on the device. Required.
operatingSystemVersionoperatingSystemVersion StringString Version du système d’exploitation de l’appareil.Operating system version of the device. Obligatoire.Required.
physicalIdsphysicalIds Collection de chaînesString collection Réservé à un usage interneFor internal use only. Ne peut pas avoir la valeur Null.Not nullable.
profileTypeprofileType StringString Type de profil de l’appareil.The profile type of the device. Valeurs possibles :Possible values:
RegisteredDevice (valeur par défaut)RegisteredDevice (default)
SecureVMSecureVM
PrinterPrinter
SharedShared
IoTIoT
systemLabelssystemLabels Collection de chaînesString collection Liste des étiquettes appliquées au périphérique par le système.List of labels applied to the device by the system.
trustTypetrustType ChaîneString Type de confiance pour l’appareil joint.Type of trust for the joined device. En lecture seule.Read-only. Valeurs possibles :Possible values:
Workplace -indique apportez vos propres appareilsWorkplace - indicates bring your own personal devices
AzureAd -appareils joints au cloud uniquementAzureAd - Cloud only joined devices
ServerAd -appareils joints au domaine sur site joints à Azure ADServerAd - on-premises domain joined devices joined to Azure AD. Pour plus d’informations, consultez la rubrique Présentation de la gestion des appareils dans Azure Active Directory.For more details, see Introduction to device management in Azure Active Directory
NomName StringString Nom convivial d’un appareil.Friendly name of a device. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome.
StatutStatus StringString L’appareil est en ligne ou hors connexion.Device is online or offline. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome.
PlateformePlatform StringString Plateforme de l’appareil.Platform of device. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome.
KindKind ChaîneString Facteur de forme du périphérique.Form factor of device. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome.
ModèleModel StringString Modèle de l’appareil.Model of device. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome.
ConstructeurManufacturer StringString Fabricant de l’appareil.Manufacturer of device. Retourné uniquement si l’utilisateur se connecte avec un compte Microsoft dans le cadre de Project Rome.Only returned if user signs in with a Microsoft account as part of Project Rome.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
extensionsextensions collection extensionextension collection Collection des extensions d’ouverture définies pour l’appareil. En lecture seule. Peut avoir la valeur Null.The collection of open extensions defined for the device. Read-only. Nullable.
registeredOwnersregisteredOwners collection directoryObjectdirectoryObject collection Utilisateur ayant joint l’appareil au cloud ou inscrit son appareil personnel.The user that cloud joined the device or registered their personal device. Le propriétaire inscrit est défini au moment de l’inscription.The registered owner is set at the time of registration. Actuellement, un seul propriétaire est autorisé.Currently, there can be only one owner. En lecture seule.Read-only. Pouvant accepter la valeur Null.Nullable.
registeredUsersregisteredUsers collection directoryObjectdirectoryObject collection Collection des utilisateurs de l’appareil inscrits.Collection of registered users of the device. Pour les appareils joints au cloud et les appareils personnels inscrits, les utilisateurs inscrits sont définis sur la même valeur que les propriétaires inscrits au moment de l’inscription.For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration. En lecture seule.Read-only. Peut avoir la valeur Null.Nullable.
extensionsextensions collection extensionextension collection Collection d’extensions d’ouverture définies pour le périphérique.The collection of open extensions defined for the device. Pouvant accepter la valeur Null.Nullable.
registeredOwnersregisteredOwners collection directoryObjectdirectoryObject collection Utilisateurs qui sont des propriétaires inscrits de l’appareil. En lecture seule. Peut avoir la valeur Null.Users that are registered owners of the device. Read-only. Nullable.
registeredUsersregisteredUsers collection directoryObjectdirectoryObject collection Utilisateurs qui sont des utilisateurs inscrits de l’appareil. En lecture seule. Peut avoir la valeur Null.Users that are registered users of the device. Read-only. Nullable.
Commandes commands collection de commandescommand collection Ensemble de commandes envoyées à cet appareilSet of commands sent to this device

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.The following is a JSON representation of the resource.

{
  "accountEnabled": true,
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "mdmAppId": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "systemLabels": ["string"],
  "trustType": "string",
  "Name": "string",
  "Status": "string",
  "Platform": "string",
  "Kind": "string",
  "Model": "string",
  "Manufacturer": "string"
}

Voir aussiSee also