Tipo de recurso de usuário

  • Artigo

Namespace: microsoft.graph

Representa uma conta de usuário do Azure Active Directory (Azure AD). Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas. Herda de directoryObject. Apenas um subconjunto de propriedades do usuário é retornado por padrão na v1.0. Para recuperar outras propriedades, você deve especifique-as em uma opção de $select consulta.

Esse recurso permite:

Métodos

Método Tipo de retorno Descrição
Listar usuários Coleção user Recuperar uma lista de objetos user.
Criar usuário user Criar um novo objeto user.
Obter usuário user Ler propriedades e relações do objeto user.
Atualizar usuário user Atualizar o objeto user.
Excluir usuário Nenhum Excluir o objeto user.
Obter delta Coleção usuário Obter as alterações incrementais para usuários.
changePassword Nenhum Atualize sua senha.
Atribuição de funções do aplicativo
List appRoleAssignments appRoleAssignment collection Obtenha as funções de aplicativos e aplicativos atribuídas a esse usuário.
Adicionar uma atribuição de função do aplicativo appRoleAssignment Atribuir uma função do aplicativo a esse usuário.
Remover uma atribuição de função do aplicativo Nenhum Remover uma atribuição de função do aplicativo desse usuário.
Calendar
Criar calendário Calendar Criar um novo Calendar postando na coleção calendars.
Criar calendarGroup CalendarGroup Criar um novo CalendarGroup postando na coleção calendarGroups.
Criar evento event Criar um novo Event postando na coleção de eventos.
findMeetingTimes meetingTimeSuggestionsResult Encontrar o tempo e locais para reunião com base na disponibilidade dos participantes, localização ou restrições de tempo.
getSchedule scheduleInformation Adquira as informações de disponibilidade para um conjunto de usuários, listas de distribuição ou recursos (salas e equipamentos) para um período de tempo especificado.
Listar calendários Coleção calendar Obter uma coleção de objetos Calendar.
Listar calendarGroups Coleção de CalendarGroup Obter uma coleção de objetos CalendarGroup.
Listar calendarView Coleção event Obter uma coleção de objetos de evento.
Listar eventos Coleção event Obter uma lista de objetos de evento na caixa de correio do usuário. A lista contém reuniões de instância única e reuniões mestres em série.
reminderView Coleção Reminder Retorna uma lista de lembretes de calendário nas horas de início e término especificadas.
Contatos
Criar contato contato Criar um novo Contact postando na coleção contacts.
Criar contactFolder pastadeContatos Criar uma nova ContactFolder postando na coleção contactFolders.
Listar contatos Coleção decontato Obter uma coleção de contatos da pasta Contatos padrão do usuário conectado.
Listar contactFolders Coleção de pastadeContatos Obter a coleção de pastas de contatos na pasta Contatos padrão do usuário conectado.
Objetos de diretório
assignLicense user Adicionar ou remover assinaturas para o usuário. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura.
checkMemberGroups Coleção de cadeias de caracteres Verifique se há uma associação em uma lista de grupos. A verificação é transitiva.
checkMemberObjects Coleção de cadeias de caracteres Verifique se há associação em uma lista de grupo, função de diretório ou objetos de unidade administrativa. Essa função é transitiva.
exportPersonalData Nenhum Envia uma solicitação de operação de política de dados, realizada por um administrador da empresa para exportar os dados de um usuário da organização.
getByIds Coleção de cadeias de caracteres Retorna os objetos de diretório especificados em uma lista de IDs.
getMemberGroups Coleção de cadeias de caracteres Retorne todos os grupos dos quais o usuário é membro. A verificação é transitiva.
getMemberObjects String collection Retorna todos os grupos e funções de diretório e unidades administrativas dos quais o usuário é membro. A verificação é transitiva.
Listar createdObjects Coleção directoryObject Obter os objetos directory criados pelo usuário da propriedade de navegação createdObjects.
Listar licenseDetails Coleção licenseDetails Obtenha uma coleção de objetos licenseDetails.
Listar ownedDevices Coleção directoryObject Obtenha os dispositivos que o usuário possui da propriedade de navegação ownedDevices.
Listar ownedObjects Coleção directoryObject Obter os objetos directory que pertencem ao usuário da propriedade de navegação ownedObjects.
Listar registeredDevices Coleção directoryObject Obter os dispositivos que estão registrados para o usuário da propriedade de navegação registeredDevices.
reprocessLicense user Reprocessar as atribuições de assinatura do usuário.
revokeSignInSessions Nenhum Revoga todos os tokens de sessão e de atualização do usuário emitidos para aplicativos, redefinindo a propriedade do usuário signInSessionsValidFromDateTime para data e a hora atuais. Força o usuário a entrar novamente nesses aplicativos.
Listar grupos excluídos Coleção directoryObject Recupere os grupos excluídos no locatário nos últimos 30 dias.
Listar grupos excluídos pertencentes ao usuário Coleção directoryObject Recupere os grupos excluídos no locatário nos últimos 30 dias e que pertencem a um usuário.
Obter grupo excluído Coleção directoryObject Recupere um grupo excluído por ID.
Restaurar grupo excluído Coleção directoryObject Restaure um grupo excluído no locatário nos últimos 30 dias.
Excluir permanentemente um grupo Coleção directoryObject Exclua permanentemente um grupo excluído do locatário.
Unidade
Obter unidade unidade Recuperar as propriedades e as relações de um recurso Drive.
Filhos de lista DriveItems Retornar uma coleção de DriveItems no relacionamento filho de um DriveItem.
Grupos
Listar joinedTeams Coleção team Obter as equipes do Microsoft Teams no qual o usuário é membro direto da propriedade de navegação joinedTeams.
Listar memberOf Coleção directoryObject Obtenha os grupos, funções de diretório e unidades administrativas das quais o usuário é membro direto. Essa operação não é transitiva.
Lista transitiveMemberOf Coleção directoryObject Obtenha os grupos, funções de diretório e as unidades administrativas das quais o usuário é membro através de afiliação direta ou transitória.
Email
Create inferenceClassificationOverride inferenceClassificationOverride Criar uma substituição da Caixa de Entrada Destaques para um remetente identificado por um endereço SMTP.
Criar MailFolder mailFolder Criar uma nova MailFolder postando na coleção mailFolders.
Criar mensagem message Criar uma nova Mensagem postando na coleção messages.
Criar messageRule messageRule Crie um objeto messageRule especificando um conjunto de condições e ações.
getMailTips Coleção mailTips Retornar dicas de email de um ou mais destinatários conforme disponíveis para o usuário conectado.
Listar mailFolders Coleção mailFolder Obter o conjunto de pastas de email sob a pasta raiz do usuário conectado.
Listar mensagens Coleção message Obter todas as mensagens na caixa de correio do usuário conectado.
List overrides Coleção inferenceClassificationOverride Obtenha as substituições da Caixa de Entrada Destaques que um usuário configurou para sempre classificar as mensagens de determinados remetentes de maneiras específicas.
Listar regras Coleção messageRule Obtenha todos os objetos messageRule definidos para a caixa de entrada do usuário.
Enviar email Nenhum Enviar a mensagem especificada no corpo da solicitação.
Anotações
Criar bloco de anotações bloco de anotações Crie um novo bloco de anotações do OneNote.
Listar blocos de anotações Coleção bloco de anotações Recuperar uma lista de objetos do bloco de anotações.
Extensões abertas
Criar extensão aberta openTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obtenha uma extensão aberta identificada pelo nome da extensão.
Hierarquia da organização
Atribuir gerente directoryObject Atribuir um usuário ou um contato organizacional como o gerente do usuário.
Obter gerenciador directoryObject Obter o usuário ou o contato organizacional que é o gerente do usuário da propriedade de navegação do gerente.
Remover gerenciador Nenhum Remova o gerente de um usuário.
Listar directReports Coleção directoryObject Obter os usuários ou contatos subordinados ao usuário da propriedade de navegação directReports.
Configurações do Outlook
Criar categoria do Outlook outlookCategory Cria um objeto outlookCategory na lista mestra de categorias do usuário.
Obter supportedLanguages, Coleção localeInfo Obtém a lista de locais e idiomas com suporte para o usuário, conforme configurado no servidor de caixa de correio do usuário.
Obter supportedTimeZones Coleção timeZoneInformation Obtém a lista de fusos horários com suporte para o usuário, conforme configurado no servidor de caixa de correio do usuário.
Obtém configurações de caixa de correio do usuário mailboxSettings Obtém as configurações de caixa de correio do usuário.
Listar as categorias do Outlook Coleção outlookCategory Obtém todas as categorias que foram definidas para o usuário.
Converter IDs do Exchange coleção convertIdResult Traduzir os identificadores de recursos relacionados ao Outlook entre formatos.
Atualizar configurações da caixa de correio do usuário mailboxSettings Habilitar, configurar ou desabilitar uma ou mais caixas de correioSettings para um usuário.
Foto
Obter foto profilePhoto Obtém o profilePhoto especificado ou seus metadados (propriedades profilePhoto).
Atualizar profilephoto Nenhum Atualiza a foto de qualquer usuário no locatário, incluindo o usuário conectado ou o grupo ou contato especificado.
Planejador
Listar tarefas Coleção plannerTask Obter o plannerTasks atribuído ao usuário.
Extensões de esquema
Adicionar valores de extensões de esquema Nenhum Cria uma definição para a extensão de esquema e usa-a para adicionar dados digitados personalizados a um recurso.
Teamwork
Lista de aplicativos instalados para o usuário ColeçãouserScopeTeamsAppInstallation Lista os aplicativos instalados no escopo pessoal de um usuário.
Obtém o aplicativo instalado para o usuário userScopeTeamsAppInstallation Lista o aplicativo especificado instalado no escopo pessoal de um usuário.
Adicionar o aplicativo para o usuário Nenhum Adiciona (instala) um aplicativo no escopo pessoal de um usuário.
Remover o aplicativo para o usuário Nenhum Remove (desinstala) um aplicativo no escopo pessoal de um usuário.
Atualizar o aplicativo instalado para o usuário Nenhum Atualizações para a versão mais recente do aplicativo instalada no escopo pessoal de um usuário.
Obter chat entre o usuário e o aplicativo Chat Lista um chat entre o usuário e o aplicativo.
Tarefas pendentes
Criar tarefa todoTask Crie um todoTask na lista de tarefas especificada.
Criar uma lista de tarefas todoTaskList Criar uma lista de tarefas To Dona caixa de correio do usuário.
Listar tarefas Coleção todoTask Obtenha todos os recursos todoTask na lista especificada.
Lista de listas de tarefas Coleção todoTaskList Obtenha todas as listas de tarefas na caixa de correio do usuário.
Configurações do usuário
Obter configurações userSettings Leia o usuário e o objeto de configurações da organização.
Atualizar configurações userSettings Atualize as propriedades do objeto de configurações.

Propriedades

Importante

O uso específico de $filter e o parâmetro de consulta $search é suportado somente quando se usa o cabeçalho ConsistencyLevel definido como eventual e $count. Para obter mais informações, consulte Recursos avançados de consulta em objetos de diretório.

Propriedade Tipo Descrição
aboutMe String Um campo de entrada de texto em forma livre para o usuário se descrever. Retornado apenas em $select.
accountEnabled Booliano true se a conta estiver habilitada; caso contrário, false. Essa propriedade é obrigatória quando um usuário é criado.

Retornado apenas em $select. Suporte $filter (eq, ne, not e in).
ageGroup ageGroup Define a faixa etária do usuário. Valores permitidos: null, Minor, NotAdult e Adult. Para obter mais informações, consulte definições legais de propriedade de faixa etária.

Retornado apenas em $select. Suporte $filter (eq, ne, not e in).
assignedLicenses Coleção assignedLicense As licenças atribuídas ao usuário, incluindo licenças herdadas (baseadas em grupo). Essa propriedade não diferencia licenças atribuídas diretamente e herdadas. Use a propriedade licenseAssignmentStates para identificar as licenças diretamente atribuídas e herdadas. Não anulável. Retornado apenas em $select. Suporta $filter (eq, not, /$count eq 0, /$count ne 0).
assignedPlans Coleção assignedPlan Os planos que são atribuídos ao usuário. Somente leitura. Não anulável.

Retornado apenas em $select. Suporte para $filter (eq e not).
birthday DateTimeOffset O aniversário do usuário. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.

Retornado apenas em $select.
businessPhones Coleção de cadeias de caracteres Números de telefone para o usuário. OBSERVAÇÃO: embora essa seja uma coleção de cadeias de caracteres, somente um número pode ser definido para essa propriedade. Somente leitura para usuários sincronizados do diretório local.

Retornado por padrão. Suporta $filter (eq, not, ge, le, startsWith).
city Cadeia de caracteres A cidade em que o usuário está localizado. O comprimento máximo é de 128 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
CompanyName String O nome da empresa à qual o usuário está associado. Essa propriedade pode ser útil para descrever a empresa de onde procede um usuário externo. O tamanho máximo é de 64 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
consentProvidedForMinor consentProvidedForMinor Define se o consentimento foi obtido para menores. Valores permitidos: null, Granted, Denied e NotRequired. Confira as definições de propriedades da faixa etária legal para obter mais informações.

Retornado apenas em $select. Suporte $filter (eq, ne, not e in).
country Cadeia de caracteres O país ou a região em que o usuário está localizado; por exemplo, US ou UK. O comprimento máximo é de 128 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
createdDateTime DateTimeOffset A data e a hora em que o usuário foi criado, no formato ISO 8601 e em tempo UTC. Não é possível modificar o valor e ele é preenchido automaticamente quando a entidade é criada. Anulável. Para usuários locais, o valor representa quando eles foram criados pela primeira vez em Azure AD. A propriedade é null para alguns usuários criados antes de junho de 2018 e usuários locais que foram sincronizados com Azure AD antes de junho de 2018. Somente leitura.

Retornado apenas em $select. Suporta $filter (eq, ne, not , ge, le, in).
creationType String Indica se a conta do usuário foi criada por meio de um dos seguintes métodos:
  • Como uma conta corporativa ou de estudante (null).
  • Como uma conta externa (Invitation).
  • Como uma conta local para um locatário do Azure Active Directory B2C (LocalAccount).
  • Por meio da inscrição de autoatendimento feita por um usuário interno usando a verificação por email (EmailVerified).
  • Por meio da inscrição de autoatendimento feita por um usuário externo que se inscreveu usando um link que faz parte de um fluxo do usuário (SelfServiceSignUp).

Somente leitura.
Retornado apenas em $select. Suporta $filter (eq, ne, not, in).
customSecurityAttributes customSecurityAttributeValue Um tipo complexo aberto que contém o valor de um atributo de segurança personalizado atribuído a um objeto do diretório. Anulável.

Retornado apenas em $select. Suporta $filter (eq, ne, not, startsWith). O valor do filtro é sensível a maiúsculas de minúsculas.
deletedDateTime DateTimeOffset A data e hora que o usuário foi excluído.

Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in).
department String O nome do departamento no qual o usuário trabalha. O comprimento máximo é de 64 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, eq em null valores).
displayName String O nome exibido para o usuário no catálogo de endereços. É geralmente a combinação do nome, da inicial do meio e do sobrenome do usuário. Essa propriedade é obrigatória quando um usuário é criado e não pode ser apagado durante atualizações. O comprimento máximo é de 256 caracteres.

Retornado por padrão. Suporta $filter (eq, ne, not , ge, le, in, startsWith, e eq em null valores), $orderby, e $search.
employeeHireDate DateTimeOffset A data e a hora em que o usuário foi contratado ou começará a trabalhar em caso de futura contratação.

Retornado apenas em $select. Suporta $filter (eq, ne, not , ge, le, in).
employeeLeaveDateTime DateTimeOffset A data e hora em que o usuário saiu ou deixará a organização.

Para ler essa propriedade, o aplicativo de chamada deve receber a permissão User-LifeCycleInfo.Read.All . Para gravar essa propriedade, o aplicativo de chamada deve receber as permissões User.Read.All e User-LifeCycleInfo.ReadWrite.All . Para ler essa propriedade em cenários delegados, o administrador precisa de uma das seguintes funções Azure AD: Administrador de Fluxos de Trabalho do Ciclo de Vida, Leitor Global ou Administrador Global. Para escrever essa propriedade em cenários delegados, o administrador precisa da função de Administrador Global .

Suporta $filter (eq, ne, not , ge, le, in).

Para obter mais informações, consulte Configurar a propriedade employeeLeaveDateTime para um usuário.
employeeId String O identificador de funcionário atribuído ao usuário pela organização. O comprimento máximo é de 16 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, not , ge, le, in, startsWith, e eq em null valores).
employeeOrgData employeeOrgData Representa dados da organização (por exemplo, divisão e costCenter) associados a um usuário.

Retornado apenas em $select. Suporta $filter (eq, ne, not , ge, le, in).
employeeType String Captura o tipo de trabalhador corporativo. Por exemplo, Employee, Contractor, Consultant ou Vendor. Retornado apenas em $select. Suporta $filter (eq, ne, not , ge, le, in, startsWith).
externalUserState String Para um usuário externo convidado para o locatário usando a API de convite, essa propriedade representa o status do convite do usuário convidado. Para usuários convidados, o estado pode ser PendingAcceptance ou Accepted ou null para todos os outros usuários.

Retornado apenas em $select. Suporta $filter (eq, ne, not , in).
externalUserStateChangeDateTime DateTimeOffset Mostra o carimbo de data/hora da alteração mais recente da propriedade externalUserState.

Retornado apenas em $select. Suporta $filter (eq, ne, not , in).
FaxNumber String O número de fax do usuário.

Retornado apenas em $select. Suporta $filter (eq, ne, not , ge, le, in, startsWith, e eq em null valores).
givenName String O nome fornecido (nome) do usuário. O comprimento máximo é de 64 caracteres.

Retornado por padrão. Suporta $filter (eq, ne, not , ge, le, in, startsWith, e eq em null valores).
hireDate DateTimeOffset A data de contratação do usuário. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.

Retornado apenas em $select.
Observação: Esta propriedade é específica do SharePoint Online. Recomendamos usar a propriedade nativa employeeHireDate para definir e atualizar os valores das datas de contratação usando as APIs do Microsoft Graph.
id String O identificador exclusivo do usuário. Deve ser tratado como um identificador opaco. Herdado de directoryObject. Chave. Não anulável. Somente leitura.

Devolvido por padrão. Suporta $filter (eq, ne, not, in).
Identidades Coleção objectIdentity Representa as identidades que podem ser usadas para entrar nesta conta de usuário. Uma identidade pode ser fornecida pela Microsoft (também conhecida como conta local), por organizações ou por provedores de identidade social, como o Facebook, Google e Microsoft, e está vinculada a uma conta de usuário. Pode conter vários itens com o mesmo valor signInType.

Retornado apenas em $select. Suporta $filter (eq) incluindo valores de null, somente quando o signInType não é userPrincipalName.
imAddresses String collection Os endereços do Protocolo de Início de Sessão (SIP) de VoIP (Voice over IP) da mensagem instantânea para o usuário. Somente leitura.

Retornado apenas em $select. Suporta $filter (eq, not, ge, le, startsWith).
interests Coleção de cadeias de caracteres Uma lista para o usuário descrever os interesses dele.

Retornado apenas em $select.
isResourceAccount Boolean Não use – reservado para uso futuro.
jobTitle String O cargo do usuário. O comprimento máximo é de 128 caracteres.

Retornado por padrão. Suporta $filter (eq, ne, not , ge, le, in, startsWith, e eq em null valores).
lastPasswordChangeDateTime DateTimeOffset A hora em que esse Azure AD usuário alterou sua senha pela última vez ou quando sua senha foi criada, qualquer que seja a data em que a ação mais recente foi executada. As informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.

Retornado apenas em $select.
legalAgeGroupClassification legalAgeGroupClassification Usado por aplicativos empresariais para determinar a faixa etária legal do usuário. Essa propriedade é somente leitura e calculada com base nas propriedades ageGroup e consentProvidedForMinor . Valores permitidos: null, MinorWithOutParentalConsent, MinorWithParentalConsent, MinorNoParentalConsentRequired, NotAdult e Adult. Confira as definições de propriedades da faixa etária legal para obter mais informações.

Retornado apenas em $select.
licenseAssignmentStates Coleção licenseAssignmentState Estado das atribuições de licenças para esse usuário. Também indica licenças atribuídas diretamente ou que o usuário herdou por meio de associações de grupo. Somente leitura.

Retornado apenas em $select.
email String O endereço SMTP do usuário, por exemplo, jeff@contoso.onmicrosoft.com. As alterações feitas nessa propriedade também atualizarão a coleção proxyAddresses do usuário para incluir o valor como um endereço SMTP. Essa propriedade não pode conter caracteres de sotaque.
NOTA: Não recomendamos atualizar essa propriedade para Azure AD perfis de usuário B2C. Use em vez da propriedade otherMails.

Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith, endsWithe eq em null valores).
mailboxSettings mailboxSettings Configurações da caixa de correio principal do usuário conectado. Você pode obter ou atualizar as configurações de localidade, fuso horário ou de envio de respostas automáticas a mensagens de entrada.

Retornado apenas em $select.
mailNickname String O alias de email do usuário. Essa propriedade deve ser especificada quando um usuário é criado. O comprimento máximo é de 64 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
mobilePhone String O número de celular principal do usuário. Somente leitura para usuários sincronizados do diretório local. O comprimento máximo é de 64 caracteres.

Retornado por padrão. $filter Dá suporte (eq, , notne, ge, le, in, startsWith, e eq em null valores) e $search.
mySite String A URL do site pessoal do usuário.

Retornado apenas em $select.
officeLocation String A localização do escritório no local de trabalho do usuário.

Retornado por padrão. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
onPremisesDistinguishedName String Contém o distinguished name do Active Directory no local ou DN. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect. Somente leitura.

Retornado apenas em $select.
onPremisesDomainName String Contém o domainFQDN local, também chamado dnsDomainName sincronizado do diretório local. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect. Somente leitura.

Retornado apenas em $select.
onPremisesExtensionAttributes onPremisesExtensionAttributes Contém extensionAttributes1-15 para o usuário. Esses atributos de extensão também são conhecidos como atributos personalizados do Exchange 1-15.
  • Para um usuário onPremisesSyncEnabled, a fonte de autoridade para este conjunto de propriedades é o local e é somente leitura.
  • Para um usuário apenas na nuvem (onde onPremisesSyncEnabled é false), essas propriedades podem ser definidas durante a criação ou atualização de um objeto de usuário.
  • Para um usuário somente na nuvem previamente sincronizado a partir do Active Directory local, essas propriedades são somente leitura no Microsoft Graph, mas podem ser totalmente gerenciadas através do Centro de Administração do Exchange ou do módulo Exchange Online V2 no PowerShell.

    • Retornado apenas em $select. Suporta $filter (eq, ne, not, in).
    onPremisesImmutableId String Essa propriedade é usada para associar uma conta de usuário do Active Directory local com seu objeto de usuário do Azure AD. Essa propriedade deve ser especificada ao criar uma nova conta de usuário no Graph se você estiver usando um domínio federado para a propriedade UPN (userPrincipalName ) do usuário. NOTA: Os $caracteres e _ não podem ser usados ao especificar essa propriedade.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in)..
    onPremisesLastSyncDateTime DateTimeOffset Indica a última vez em que o objeto foi sincronizado com o diretório local; por exemplo: 2013-02-16T03:04:54Z. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in).
    onPremisesProvisioningErrors coleção OnPremisesProvisioningError Erros ao usar o produto de sincronização da Microsoft durante a configuração.

    Retornado apenas em $select. Suporta $filter (eq, not, ge, le).
    onPremisesSamAccountName String Contém o samAccountName local sincronizado no diretório local. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect. Somente leitura.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith).
    onPremisesSecurityIdentifier String Contém o identificador de segurança (SID) local do usuário que foi sincronizado do local com a nuvem. Somente leitura.

    Retornado apenas em $select. Suporta $filter(eq inclusive em null valores).
    onPremisesSyncEnabled Booliano true se esse objeto de usuário estiver sendo sincronizado de um Active Directory (AD) local; caso contrário, o usuário não está sendo sincronizado e pode ser gerenciado no Azure Active Directory (Azure AD). Somente leitura.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, in e eq em null valores).
    onPremisesUserPrincipalName String Contém o userPrincipalName local sincronizado no diretório local. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect. Somente leitura.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith).
    otherMails Coleção String Uma lista de endereços de email adicional para o usuário; Por exemplo: ["bob@contoso.com", "Robert@fabrikam.com"].
    OBSERVAÇÃO: essa propriedade não pode conter caracteres de ênfase.

    Retornado apenas em $select. $filter Dá suporte (eq, , not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).
    passwordPolicies String Especifica as políticas de senha do usuário. Este valor é uma enumeração com um valor possível sendo DisableStrongPassword, que permite que senhas mais fracas do que a política padrão sejam especificadas. DisablePasswordExpiration também pode ser especificado. Os dois podem ser especificados juntos; por exemplo: DisablePasswordExpiration, DisableStrongPassword.

    Retornado apenas em $select. Para obter mais informações sobre as políticas de senha padrão, consulte Azure AD políticas de senha. Suporte $filter (ne, not, e eq no null valores).
    passwordProfile passwordProfile Especifica o perfil de senha do usuário. O perfil contém a senha do usuário. Essa propriedade é obrigatória quando um usuário é criado. A senha no perfil deve atender a requisitos mínimos, conforme especificado pela propriedade passwordPolicies. Por padrão, é obrigatória uma senha forte.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, in e eq em null valores).
    pastProjects Coleção de cadeias de caracteres Uma lista para o usuário enumerar seus projetos anteriores.

    Retornado apenas em $select.
    postalCode String O código postal do endereço postal do usuário. O código postal é específico para o país/região do usuário. Nos Estados Unidos, esse atributo contém o CEP. O comprimento máximo é de 40 caracteres.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
    preferredDataLocation String O local de dados preferido para o usuário. Para saber mais, confira OneDrive Online Multi-Geo.
    preferredLanguage String O idioma preferencial do usuário. Deve seguir o Código ISO 639-1; por exemplo, en-US.

    Devolvido por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith e eq em valores null)
    preferredName String O nome preferencial do usuário. Sem suporte. Esse atributo retorna uma cadeia de caracteres vazia.

    Retornado apenas em $select.
    provisionedPlans coleção provisionedPlan Os planos que estão provisionados para o usuário. Somente leitura. Não anulável.

    Retornado apenas em $select. Suporta $filter (eq, not, ge, le).
    proxyAddresses Coleção de cadeias de caracteres Por exemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. As alterações na propriedade mail também atualizarão essa coleção para incluir o valor como um endereço SMTP. Para obter mais informações, consulte propriedades de email e proxyAddresses. O endereço proxy prefixado com SMTP (em maiúsculas) é o endereço proxy primário, enquanto aqueles prefixados com smtp são os endereços proxy secundários. Para Azure AD contas B2C, essa propriedade tem um limite de 10 endereços exclusivos. Somente leitura no Microsoft Graph; você pode atualizar essa propriedade somente por meio do Microsoft 365 de administração. Não anulável.

    Retornado apenas em $select. Suporta $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).
    refreshTokensValidFromDateTime DateTimeOffset Todos os tokens de atualização ou tokens de sessões (cookies de sessão) emitidos antes dessa hora são inválidos e os aplicativos recebem um erro ao usar um token de atualização ou sessões inválidos para adquirir um token de acesso delegado (para acessar APIs como o Microsoft Graph). Se isso acontecer, o aplicativo precisará adquirir um novo token de atualização fazendo uma solicitação para o ponto de extremidade autorizado.

    Retornado apenas em $select. Apenas leitura.
    responsibilities Coleção de cadeias de caracteres Uma lista para o usuário enumerar suas responsabilidades.

    Retornado apenas em $select.
    schools Coleção de cadeias de caracteres Uma lista para o usuário enumerar as escolas que frequentou.

    Retornado apenas em $select.
    securityIdentifier Cadeia de Caracteres Identificador de segurança (SID) do usuário, usado em cenários do Windows.

    Somente leitura. Devolvido por padrão.
    Suporta $select e $filter (eq, not, ge, le, startsWith).
    showInAddressList Booliano Não use no Microsoft Graph. Gerencie essa propriedade por meio do Centro de administração do Microsoft 365. Representa se o usuário deve ser incluído na lista de endereços global do Outlook. Consulte Problema conhecido.
    signInActivity signInActivity Obtenha a última data de entrada e solicite a ID de entrada de um usuário específico. Somente leitura.

    Retornado apenas em $select. Dá suporte (eq, , notne, , ge), lemas não com outras$filter propriedades filtradas.

    Observação:
  • Os detalhes dessa propriedade exigem uma licença Azure AD Premium P1/P2 e a permissão AuditLog.Read.All.
  • Essa propriedade não é retornada para um usuário que nunca entrou ou entrou pela última vez antes de abril de 2020.
    		•
    signInSessionsValidFromDateTime DateTimeOffset Todos os tokens de atualização ou tokens de sessões (cookies de sessão) emitidos antes dessa hora são inválidos e os aplicativos recebem um erro ao usar um token de atualização ou sessões inválidos para adquirir um token de acesso delegado (para acessar APIs como o Microsoft Graph). Se isso acontecer, o aplicativo precisará adquirir um novo token de atualização fazendo uma solicitação para o ponto de extremidade autorizado. Somente leitura. Use revokeSignInSessions para redefinir.

    Retornado apenas em $select.
    skills Coleção de cadeias de caracteres Uma lista para o usuário enumerar suas qualificações.

    Retornado apenas em $select.
    state String O estado ou município no endereço do usuário. O comprimento máximo é de 128 caracteres.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
    streetAddress String O endereço do local de trabalho do usuário. O comprimento máximo é de 1024 caracteres.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
    surname String O sobrenome do usuário (nome de família ou sobrenome). O comprimento máximo é de 64 caracteres.

    Retornado por padrão. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    usageLocation String Um código de duas letras (padrão ISO 3166). Necessário para usuários que recebem licenças devido a requisitos legais para marcar para disponibilidade de serviços em países. Os exemplos incluem:US,JP e GB. Não anulável.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores).
    userPrincipalName String O nome UPN do usuário. O UPN é um nome de entrada no estilo internet para o usuário com base no RFC 822 padrão da Internet. Por convenção, ele deve ser mapeado para o nome de email do usuário. O formato geral é alias@domain, onde o domínio deve estar presente na coleta de domínios verificados pelo locatário. Essa propriedade é obrigatória quando um usuário é criado. Os domínios verificados para o locatário podem ser acessados pela propriedade verifiedDomains de organization.
    OBSERVAÇÃO: essa propriedade não pode conter caracteres de ênfase. Somente os seguintes caracteres são permitidos A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Para obter a lista completa de caracteres permitidos, consulte as políticas de nome de usuário.

    Retornado por padrão. Suporta $filter (eq, ne, not, ge, le, in, startsWith, endsWith) e $orderby.
    userType String Um valor de string que pode ser usado para classificar tipos de usuário em seu diretório, como Member e Guest.

    Retornado apenas em $select. Suporta $filter (eq, ne, not, in e eq em null valores). OBSERVAÇÃO: Para obter mais informações sobre as permissões para usuários membros e convidados, consulte Quais são as permissões padrão de usuário em Azure Active Directory?

    Dica

    As extensões de diretório e esquema e seus dados associados são retornados apenas em $select; as extensões abertas e seus dados associados são retornados apenas em $expand.

    propriedades mail e proxyAddresses

    email e proxyAddresses são propriedades relacionadas a email. proxyAddresses é uma coleção de endereços relevantes apenas para o servidor do Microsoft Exchange. Ele é usado para armazenar uma lista de endereços de email para um usuário que está vinculado a uma única caixa de correio. email propriedade é usada como o endereço de email do usuário para várias finalidades, incluindo a entrada do usuário e define o endereço proxy principal.

    O email e o proxyAddresses podem ser recuperados por meio da API de usuário GET . Você pode atualizar o email por meio da API do usuário de atualização , mas não pode atualizar proxyAddresses por meio do Microsoft Graph. Quando a propriedade de email de um usuário é atualizada, ela aciona o recálculo de proxyAddresses e o email recém-atualizado é definido como o endereço de proxy primário, exceto nos seguintes cenários:

    1. Se um usuário tiver uma licença que inclua o Microsoft Exchange, todos os endereços proxy deverão pertencer a um domínio verificado no locatário. Qualquer um que não pertença a domínios verificados é removido silenciosamente.
    2. O email de um usuário NÃO será definido como o endereço de proxy primário se o usuário for um convidado e o endereço de proxy primário contiver a cadeia de caracteres UPN do usuário convidado com #EXT#.
    3. O email de um usuário NÃO será removido, mesmo que ele não tenha mais endereços proxy, se o usuário for um convidado.

    proxyAddresses são exclusivos entre objetos de diretório (usuários, grupos e contatos organizacionais). Se a propriedade de email de um usuário entrar em conflito com um dos proxyAddresses de outro objeto, uma tentativa de atualizar o email falhará e a propriedade proxyAddresses também não será atualizada.

    Esta seção explica como as três propriedades de grupo idade (legalAgeGroupClassification, ageGroup e consentProvidedForMinor) são usadas por administradores do Azure Active Directory e desenvolvedores de aplicativos empresariais para atender às regulamentações relacionadas à idade:

    • A propriedade legal AgeGroupClassification é somente leitura. Ele é usado por desenvolvedores de aplicativos corporativos para garantir o tratamento correto de um usuário com base em sua faixa etária legal. Ele é calculado com base nas propriedades ageGroup e consentProvidedForMinor do usuário.
    • ageGroup e consentProvidedForMinor são propriedades opcionais usadas pelos administradores do Azure Active Directory para ajudar a garantir que o uso de uma conta seja tratado corretamente com base nas regras regulatórias relacionadas à idade que regem o país ou região do usuário.

    Por exemplo: Cameron é o administrador de um diretório em uma escola de ensino fundamental em Holyport, no Reino Unido. No início do ano letivo ele usa a documentação de admissão para obter o consentimento dos pais dos menores baseado nos regulamentos relacionadas com a idade no Reino Unido. O consentimento obtido do pai permite que a conta do menor seja usado pela escola de Holyport e os aplicativos da Microsoft. Cameron cria todas as contas e define ageGroup como minor e consentProvidedForMinor como granted. Os aplicativos usados ​​por seus alunos podem suprimir recursos que não são adequados para menores.

    legalAgeGroupClassification values

    Member Descrição
    null Valor padrão, nenhum ageGroup foi definido para o usuário.
    MenorSemConsentimentoDosPais (Reservado para uso futuro)
    MenorComConsentimentoDosPais O usuário é considerado menor baseado nos regulamentos relacionados com a idade de seu país ou região, e o administrador da conta obteve o consentimento apropriado dos pais ou responsável.
    Adulto O usuário é considerado adulto baseado nos regulamentos relacionadas com a idade do seu país ou região.
    NãoAdulto O usuário é de um país ou região com regulamentações adicionais relacionados à idade (por exemplo, Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do usuário está entre menor e adulto (como estipulado com base no país ou região). De forma geral, isso significa que os adolescentes são considerados como notAdult em países com regulamentação.
    MenorSemExigênciaDeConsentimentoDosPais O usuário é menor de idade, mas é de um país ou região que não tem com regulamentações relacionadas com a idade.

    ageGroup values

    Member Descrição
    null Valor padrão, nenhum ageGroup foi definido para o usuário.
    Secundária O usuário é considerado um menor.
    NãoAdulto O usuário é de um país que possui regulamentos legais (como Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do usuário é superior ao limite superior de idade infantil (conforme o país) e inferior ao limite inferior de adulto idade (conforme estipulado com base no país ou região). Basicamente, os adolescentes são considerados como notAdult em países com regulamentação.
    Adulto O usuário deve ser tratado como um adulto.

    consentProvidedForMinor values

    Member Descrição
    null Valor padrão, nenhum consentimentoProvidedForMinor foi definido para o usuário.
    Concedido O consentimento foi obtido para o usuário ter uma conta.
    Negado O consentimento não foi obtido para que o usuário tenha uma conta.
    NãoExigido O usuário é de um local que não requer consentimento.

    Relações

    Relação Tipo Descrição
    activities Coleção userActivity Atividades do usuário em vários dispositivos. Somente leitura. Anulável.
    agreementAcceptances Coleção agreementAcceptance Os termos de usuário do status de aceitação de uso. Somente leitura. Anulável.
    appRoleAssignments appRoleAssignment collection Representa as funções de aplicativo que um usuário recebeu para um programa. Suporta o $expand.
    autenticação autenticação Os métodos de autenticação com suporte para o usuário.
    calendar calendar O calendário principal do usuário. Somente leitura.
    calendarGroups Coleção CalendarGroup Os grupos de calendários do usuário. Somente leitura. Anulável.
    calendars Coleção calendar Os calendários do usuário. Somente leitura. Anulável.
    calendarView Coleção event O modo de exibição do calendário. Somente leitura. Anulável.
    contactFolders Coleção ContactFolder As pastas de contatos do usuário. Somente leitura. Anulável.
    contacts Coleção Contact Os contatos do usuário. Somente leitura. Anulável.
    createdObjects Coleção directoryObject Objetos de diretório que o usuário criou. Somente leitura. Anulável.
    directReports Coleção directoryObject Os usuários e contatos subordinados ao usuário. (Os usuários e contatos cuja propriedade manager está definida como esse usuário.) Somente leitura. Anulável. Suporta o $expand.
    Unidade drive O OneDrive do usuário. Somente leitura.
    unidades Coleção drive Uma coleção de unidades disponíveis para esse usuário. Somente leitura.
    events Coleção event Os eventos do usuário. O padrão é mostrar eventos no Calendário Padrão. Somente leitura. Anulável.
    extensions Coleção extension A coleção de extensões abertas definidas para o usuário. Somente leitura. Oferece suporte para $expand. Anulável.
    inferenceClassification inferenceClassification Classificação de relevância das mensagens do usuário com base em designações explícitas que substituem relevância ou importância inferidas.
    insights officeGraphInsights Somente leitura. Anulável.
    licenseDetails Coleção delicenseDetails Uma coleção de detalhes da licença do usuário. Somente leitura.
    mailFolders Coleção mailFolder As pastas de email do usuário. Somente leitura. Anulável.
    manager directoryObject O usuário ou contato que é o gerente deste usuário. Somente leitura. (Métodos HTTP: GET, PUT, DELETE.). Suporta o $expand.
    memberOf Coleção directoryObject Os grupos e as funções de diretório dos quais o usuário é membro. Somente leitura. Anulável. Suporta o $expand.
    messages Coleção message As mensagens em uma caixa de correio ou pasta. Somente leitura. Anulável.
    onenote onenote Somente leitura.
    onlineMeetings Coleção onlineMeeting Informações sobre uma reunião, incluindo a URL usada para participar de uma reunião, a lista de participantes e a descrição.
    outlook outlookUser Somente leitura.
    ownedDevices Coleção directoryObject Dispositivos que pertencem ao usuário. Somente leitura. Anulável. $expand Dá suporte e $filter (/$count eq 0, , /$count ne 0, /$count ne 1/$count eq 1).
    ownedObjects Coleção directoryObject Objetos de diretório que pertencem ao usuário. Somente leitura. Anulável. $expandDá suporte a , $select aninhado em $expand, e $filter (/$count eq 0, , /$count ne 0/$count eq 1, /$count ne 1).
    people Coleção person Pessoas que são relevantes para o usuário. Somente leitura. Anulável.
    photo profilePhoto A foto de perfil do usuário. Somente leitura.
    planner plannerUser Ponto de entrada para o recurso Planejador que pode existir para um usuário. Somente leitura.
    registeredDevices Coleção directoryObject Dispositivos que estão registrados para o usuário. Somente leitura. Anulável. Suporta o $expand.
    trabalho em equipe userTeamwork Um contêiner dos recursos do Microsoft Teams disponíveis para o usuário. Somente leitura. Anulável.
    todo todo Representa os serviços To Do disponíveis para um usuário.
    transitiveMemberOf Coleção directoryObject Os grupos, incluindo os grupos aninhados, e as funções de diretório dos quais um usuário é membro. Anulável.

    Representação JSON

    Veja a seguir uma representação JSON do recurso.

    {
  "aboutMe": "String",
  "accountEnabled": true,
  "ageGroup": "String",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "birthday": "String (timestamp)",
  "businessPhones": ["String"],
  "city": "String",
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "String (timestamp)",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
  "employeeType": "String",
  "faxNumber" : "String",
  "givenName": "String",
  "hireDate": "String (timestamp)",
  "id": "String (identifier)",
  "identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
  "imAddresses": ["String"],
  "interests": ["String"],
  "isResourceAccount": false,
  "jobTitle": "String",
  "legalAgeGroupClassification": "String",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "lastPasswordChangeDateTime": "String (timestamp)",
  "mail": "String",
  "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
  "mailNickname": "String",
  "mobilePhone": "String",
  "mySite": "String",
  "officeLocation": "String",
  "onPremisesDistinguishedName": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "String",
  "otherMails": ["String"],
  "passwordPolicies": "String",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "pastProjects": ["String"],
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "preferredName": "String",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["String"],
  "responsibilities": ["String"],
  "schools": ["String"],
  "securityIdentifier": "String",
  "showInAddressList": true,
  "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"},
  "signInSessionsValidFromDateTime": "String (timestamp)",
  "skills": ["String"],
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",

  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarGroups": [{ "@odata.type": "microsoft.graph.calendarGroup" }],
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "calendars": [ {"@odata.type": "microsoft.graph.calendar"} ],
  "contacts": [ { "@odata.type": "microsoft.graph.contact" } ],
  "contactFolders": [ { "@odata.type": "microsoft.graph.contactFolder" } ],
  "createdObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "directReports": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" } ],
  "events": [ { "@odata.type": "microsoft.graph.event" } ],
  "inferenceClassification": { "@odata.type": "microsoft.graph.inferenceClassification" },
  "mailFolders": [ { "@odata.type": "microsoft.graph.mailFolder" } ],
  "manager": { "@odata.type": "microsoft.graph.directoryObject" },
  "memberOf": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "outlook": { "@odata.type": "microsoft.graph.outlookUser" },
  "ownedDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "ownedObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "registeredDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ]
}

    Confira também