tipo de recurso de dispositivodevice resource type

Representa um dispositivo registrado na organização.Represents a device registered in the organization. Dispositivos são criados na nuvem usando o Serviço de Registro de Dispositivo ou por meio do Intune.Devices are created in the cloud using the Device Registration Service or by Intune. Eles são usados por políticas de acesso condicional para a autenticação multifator.They're used by conditional access policies for multi-factor authentication. Estes dispositivos podem variar desde computadores desktop e laptops até telefones e tablets.These devices can range from desktop and laptop machines to phones and tablets. Herda de directoryObject.Inherits from directoryObject.

Esse recurso permite que você adicione seus próprios dados às propriedades personalizadas usando extensions.This resource lets you add your own data to custom properties using extensions.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Obter dispositivoGet device devicedevice Leia as propriedades e os relacionamentos de um objeto device.Read properties and relationships of a device object.
Listar dispositivosList devices Coleção devicedevice collection Recupere uma lista de dispositivos registrados no diretório.Retrieve a list of devices registered in the directory.
Atualizar dispositivoUpdate device devicedevice Atualize as propriedades de um objeto device.Update the properties of a device object.
Excluir dispositivoDelete device NenhumaNone Exclua um objeto device.Delete a device object.
Listar memberOfList memberOf Coleção directoryObjectdirectoryObject collection Lista os grupos dos quais o dispositivo é membro direto.List the groups that the device is a direct member of.
Listar registeredOwnersList registeredOwners Coleção directoryObjectdirectoryObject collection Obtenha os usuários que são proprietários registrados do dispositivo da propriedade de navegação registeredOwners.Get the users that are registered owners of the device from the registeredOwners navigation property.
Listar registeredUsersList registeredUsers Coleção directoryObjectdirectoryObject collection Obtenha os usuários registrados do dispositivo da propriedade de navegação registeredUsers.Get the registered users of the device from the registeredUsers navigation property.
checkMemberObjectscheckMemberObjects Coleção de cadeias de caracteresString collection Verifique a associação em uma lista de grupo, função de diretório ou objetos de unidade administrativa.Check for membership in a list of group, directory role, or administrative unit objects.
Extensões abertasOpen extensions
Criar extensão abertaCreate open extension openTypeExtensionopenTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.Create an open extension and add custom properties to a new or existing resource.
Obter extensão abertaGet open extension Coleção openTypeExtensionopenTypeExtension collection Obtenha uma extensão aberta identificada pelo nome da extensão.Get an open extension identified by the extension name.
Extensões de esquemaSchema extensions
Adicionar valores de extensões de esquemaAdd schema extension values Criar uma definição para a extensão de esquema e usá-la para adicionar dados digitados personalizados a um recurso.Create a schema extension definition and then use it to add custom typed data to a resource.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
accountEnabledaccountEnabled BooleanBoolean true se a conta estiver habilitada; caso contrário, false. Obrigatório.true if the account is enabled; otherwise, false. Required.
alternativeSecurityIdsalternativeSecurityIds Coleção alternativeSecurityIdalternativeSecurityId collection Apenas para uso interno.For internal use only. Não anulável.Not nullable.
approximateLastSignInDateTimeapproximateLastSignInDateTime DateTimeOffsetDateTimeOffset O tipo TIMESTAMP representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Somente leitura.Read-only.
complianceExpirationDateTimecomplianceExpirationDateTime DateTimeOffsetDateTimeOffset O carimbo de data/hora quando o dispositivo não é mais considerado compatível.The timestamp when the device is no longer deemed compliant. O tipo TIMESTAMP representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Somente leitura.Read-only.
deviceIddeviceId stringstring Identificador exclusivo definido pelo serviço de registro do dispositivo Azure no momento do registro.Unique identifier set by Azure Device Registration Service at the time of registration.
deviceMetadatadeviceMetadata Cadeia de CaracteresString Somente para uso interno.For interal use only. Definido como nulo.Set to null.
deviceVersiondeviceVersion Int32Int32 Somente para uso interno.For interal use only.
displayNamedisplayName Cadeia de caracteresString O nome de exibição do dispositivo. Obrigatório.The display name for the device. Required.
idid StringString O identificador exclusivo do dispositivo. Herdado de directoryObject. Chave, Não anulável. Somente leitura.The unique identifier for the device. Inherited from directoryObject. Key, Not nullable. Read-only.
isCompliantisCompliant BooleanBoolean True se o dispositivo está em conformidade com políticas de MDM (Gerenciamento de Dispositivo Móvel); caso contrário, false.true if the device complies with Mobile Device Management (MDM) policies; otherwise, false. Somente leitura.Read-only. Isso só pode ser atualizado pelo Intune para qualquer tipo de sistema operacional do dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
isManagedisManaged BoolianoBoolean true se o dispositivo for gerenciado por um aplicativo de gerenciamento de dispositivo móvel (MDM); caso contrário, false.true if the device is managed by a Mobile Device Management (MDM) app; otherwise, false. Isso só pode ser atualizado pelo Intune para qualquer tipo de sistema operacional do dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
fabricantemanufacturer StringString O fabricante do dispositivo.Manufacturer of the device. Somente leitura.Read-only.
mdmAppIdmdmAppId Cadeia de CaracteresString Identificador de aplicativo usado para registrar o dispositivo no MDM.Application identifier used to register device into MDM.

Somente leitura.Read-only. Oferece suporte a $filter.Supports $filter.
modelomodel Cadeia de CaracteresString Modelo do dispositivo.Model of the device. Somente leitura.Read-only.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset A última vez em que o objeto foi sincronizado com o diretório local. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário 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. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z' Somente leitura.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean True se esse objeto está sincronizado de um diretório local; false se esse objeto foi originalmente sincronizado de um diretório local, mas não está mais sincronizado; null se esse objeto nunca foi sido sincronizado de um diretório local (padrão).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). Somente leitura.Read-only.
operatingSystemoperatingSystem Cadeia de caracteresString O tipo de sistema operacional do dispositivo. Obrigatório.The type of operating system on the device. Required.
operatingSystemVersionoperatingSystemVersion StringString A versão do sistema operacional do dispositivo. Obrigatório.The version of the operating system on the device. Required.
physicalIdsphysicalIds Coleção de cadeia de caracteresString collection Somente para uso interno.For interal use only. Não anulável.Not nullable.
profiletypeprofileType Cadeia de CaracteresString O tipo de perfil do dispositivo.The profile type of the device. Valores possíveis:Possible values:
RegisteredDevice (padrão)RegisteredDevice (default)
SecureVMSecureVM
PrinterPrinter
CompartilhadoShared
IoTIoT
systemLabelssystemLabels Coleção de cadeias de caracteresString collection Lista de rótulos aplicados ao dispositivo pelo sistema.List of labels applied to the device by the system.
trustTypetrustType Cadeia de caracteresString Tipo de relação de confiança para o dispositivo associado.Type of trust for the joined device. Somente leitura.Read-only. Valores possíveis:Possible values:
Workplace – indica traga seus dispositivos pessoaisWorkplace - indicates bring your own personal devices
AzureAd – apenas dispositivos associados na nuvemAzureAd - Cloud only joined devices
ServerAd – dispositivos associados no domínio local unidos ao Azure AD.ServerAd - on-premises domain joined devices joined to Azure AD. Saiba mais em Introdução ao gerenciamento de dispositivo no Azure Active DirectoryFor more details, see Introduction to device management in Azure Active Directory

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
extensionsextensions extension collectionextension collection A coleção de extensões abertas definidas para o dispositivo. Somente leitura. Anulável.The collection of open extensions defined for the device. Read-only. Nullable.
memberOfmemberOf Coleção directoryObjectdirectoryObject collection Grupos dos quais esse grupo é membro. Métodos HTTP: GET (com suporte para todos os grupos). Somente leitura. Anulável.Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable.
Listar memberOf transitivosList transitive memberOf directoryObject collectiondirectoryObject collection Listar os grupos dos quais o dispositivo é membro.List the groups that the device is a member of. Essa operação é transitiva.This operation is transitive.
registeredOwnersregisteredOwners Coleção directoryObjectdirectoryObject collection O usuário que associou o dispositivo na nuvem ou registrou seu dispositivo pessoal.The user that cloud joined the device or registered their personal device. O proprietário registrado é definido no momento do registro.The registered owner is set at the time of registration. Atualmente, só pode haver um proprietário.Currently, there can be only one owner. Somente leitura.Read-only. Anulável.Nullable.
registeredUsersregisteredUsers Coleção directoryObjectdirectoryObject collection Coleção de usuários registrados do dispositivo.Collection of registered users of the device. Para dispositivos associados em nuvem e dispositivos pessoais registrados, os usuários registrados são definidos para o mesmo valor que proprietários registrados no momento do registro.For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration. Somente leitura.Read-only. Anulável.Nullable.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recursoHere is a JSON representation of the resource

{
  "accountEnabled": true,
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "manufacturer": "string",
  "mdmAppId": "string",
  "model": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "systemLabels": ["string"],
  "trustType": "string"
}

Confira tambémSee also