Tipo de recurso de usuário

Namespace: microsoft.graph

Representa uma conta de usuário do Azure AD. Herda de directoryObject.

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.
Atribuição de funções do aplicativo
List appRoleAssignments appRoleAssignment collection Obter os aplicativos e funções do aplicativo atribuídos 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 Obtenha uma coleção do objeto Event.
Listar eventos Coleção event Obter uma lista de objetos event 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 objetos de grupo, função de diretório ou unidade administrativa. A 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 a partir de 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 Coleção de cadeias de caracteres Retorna todos os grupos e funções de diretório 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 Obter os dispositivos que pertencem ao usuário 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.
Drive
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 Obter os grupos e as funções de diretório dos quais o usuário é membro direto da propriedade de navegação memberOf.
Listar memberOf transitivos Coleção directoryObject Enumera os grupos e as funções de diretório dos quais o usuário é membro. Essa operação é transitiva e inclui os grupos dos quais o usuário é membro aninhado.
Email
Create 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.
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 [timeZoneInformation](timezoneinformation.md collection) 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 o mailboxSettings de um ou mais usuários.
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

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. 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).
assignedLicenses Coleção assignedLicense As licenças atribuídas ao usuário, incluindo licenças herdadas (baseadas em grupo). Não anulável. Retornado apenas em $select. Suporte para $filter (eq e NOT).
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 Os números de telefone do usuário. OBSERVAÇÃO: Embora esta seja uma coleção de cadeia de caracteres, somente um número pode ser definido para esta propriedade. Somente leitura para usuários sincronizados do diretório local.

Devolvido por padrão. Suporte para $filter (eq e NOT).
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).
companyName String O nome da empresa em que o usuário está associado. Essa propriedade pode ser útil para descrever a empresa de onde procede um usuário externo. O comprimento máximo do nome da empresa é 64 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
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/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).
createdDateTime DateTimeOffset A data de criação do objeto de usuário. Somente leitura.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT , ge, lee operadores in ) e $orderBy.
creationType String Indica se a conta de usuário foi criada como uma conta corporativa ou de estudante (null), uma conta externa (Invitation), uma conta local para um locatário do Azure Active Directory B2C (LocalAccount) ou uma inscrição de autoatendimento usando a verificação de email (EmailVerified). Somente leitura.

Retornado apenas em $select. Suporte $filter (eq, ne, NOT e in).
deletedDateTime DateTimeOffset A data e hora que o usuário foi excluído.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT, ge, lee in) e $orderBy.
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, lee operadores in ).
displayName String O nome exibido no catálogo de endereços para o usuário. Geralmente é a combinação do nome do usuário, inicial do meio e sobrenome. Esta propriedade é necessária quando um usuário é criado e não pode ser limpa durante as atualizações. O comprimento máximo é de 256 caracteres.

Retornado por padrão. Suporta $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBye $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).
employeeId String O identificador de funcionário atribuído ao usuário pela organização.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT , ge, le, in, startsWith).
employeeOrgData employeeOrgData Representa os 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).
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).
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).
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) apenas 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).
lastPasswordChangeDateTime DateTimeOffset A hora em que o usuário do Azure AD alterou a senha dele pela última vez. 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ça para este usuário. Somente leitura.

Retornado apenas em $select.
email String O endereço SMTP do usuário, por exemplo, jeff@contoso.onmicrosoft.com.
OBSERVAÇÃO: embora essa propriedade possa conter caracteres acentuados, eles podem causar problemas de acesso aos aplicativos primários do usuário. 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. Embora essa propriedade possa conter caracteres acentuados, eles podem causar problemas de acesso aos outros aplicativos Microsoft do usuário.

Retornado por padrão. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).
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).
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. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
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. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
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 extensionAttributes 1-15 para o usuário. Observe que os atributos de extensão individuais não são selecionáveis nem filtráveis. Para um usuário do onPremisesSyncEnabled, a fonte de autoridade desse conjunto de propriedades é o local e é somente para leitura. Para um usuário somente na nuvem (onde onPremisesSyncEnabled é falso), essas propriedades podem ser definidas durante a criação ou atualização. Esses atributos de extensão também são conhecidos como atributos personalizados do Exchange 1-15.

Retornado apenas em $select. Suporta $filter (eq, NOT, ge, le, 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. Esta 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 userPrincipalName (UPN). OBSERVAÇÃO: Os caracteres $ e _ não podem ser usados ao especificar esta 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.
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, ne, NOT, in).
onPremisesSyncEnabled Booliano 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). Somente leitura.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT, in).
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: embora essa propriedade possa conter caracteres acentuados, eles podem causar problemas de acesso aos aplicativos primários para o usuário.

Retornado apenas em $select. Suporta $filter (eq, NOT, ge, le, in, startsWith).
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. Suporta $filter (eq, ne, NOT).
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. OBSERVAÇÃO: Para locatários B2C do Azure, a propriedade forceChangePasswordNextSignIn deve ser definida como false e, em vez disso, usar políticas personalizadas e fluxos de usuário para forçar a redefinição de senha no primeiro logon. Confira Forçar a redefinição de senha no primeiro logon.

Retornado apenas em $select.
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 da América, este atributo contém o Código postal. O comprimento máximo é de 40 caracteres.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
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)
preferredName String O nome preferencial do usuário.

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.
proxyAddresses Coleção de cadeias de caracteres Por exemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Somente leitura, Não anulável.

Retornado apenas em $select. Suporta $filter (eq, NOT, ge, le, startsWith).
refreshTokensValidFromDateTime DateTimeOffset Os tokens de atualização ou de sessão (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 de sessão inválido 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 ao ponto de extremidade de autorização.

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.
showInAddressList Booliano true se a lista de endereços global do Outlook deve conter o usuário, caso contrário false. Se não estiver configurado, isso será tratado como true. Para os usuários convidados por meio do Gerenciador de convites, essa propriedade será definida como false.

Retornado apenas em $select. Suporta $filter (eq, ne, NOT, in).
skills Coleção de cadeias de caracteres Uma lista para o usuário enumerar suas qualificações.

Retornado apenas em $select.
signInSessionsValidFromDateTime DateTimeOffset Os tokens de atualização ou de sessão (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 de sessão inválido 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 ao ponto de extremidade de autorização. Somente leitura. Use revokeSignInSessions para redefinir.

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).
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).
surname String O sobrenome do usuário (nome de família ou sobrenome). O comprimento máximo é de 64 caracteres.

Retornado por padrão. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
usageLocation String Um código de duas letras (padrão ISO 3166). Obrigatório para os usuários que receberão licenças devido à exigência legal de verificar a disponibilidade de serviços nos 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).
userPrincipalName String O nome UPN do usuário. O nome UPN é um nome de logon para o usuário ao estilo da Internet com base na 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: embora essa propriedade possa conter caracteres acentuados, eles podem causar problemas de acesso aos aplicativos primários para o 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, startsWith, endsWith).

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. É usado por desenvolvedores de aplicativos corporativos para garantir o tratamento correto de um usuário com base em sua faixa etária legal. É 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.
minorWithoutParentalConsent (Reservado para uso futuro)
minorWithParentalConsent 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.
adult O usuário é considerado adulto baseado nos regulamentos relacionadas com a idade do seu país ou região.
notAdult 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). Em geral, isso significa que adolescentes são considerados como notAdult em países regulamentados.
minorNoParentalConsentRequired 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.
menor O usuário é considerado um menor.
notAdult 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, adolescentes são considerados como notAdult em países regulamentados.
adult 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.
denied O consentimento não foi obtido para o usuário ter uma conta.
notRequired O usuário é de um local que não exige consentimento.

Relações

Relação Tipo Descrição
agreementAcceptances Coleção agreementAcceptance Status de aceitação dos termos de uso do usuário. Somente leitura. Anulável.
activities Coleção userActivity As atividades do usuário em todos os dispositivos. Somente leitura. Anulável.
appRoleAssignments appRoleAssignment collection Representa as funções de aplicativo que um usuário recebeu para um programa.
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.
calendarView Coleção event O modo de exibição do calendário. Somente leitura. Anulável.
calendars Coleção calendar Os calendários do usuá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 directory que foram criados pelo usuário. 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.
drive drive O OneDrive do usuário. Somente leitura.
unidades Coleção drive Uma coleção de unidades disponíveis para este 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 extension collection A coleção de extensões abertas definidas para o usuário. Somente leitura. Anulável.
inferenceClassification inferenceClassification Classificação de relevância das mensagens do usuário com base em designações explícitas que substituem a relevância ou importância deduzida.
insights officeGraphInsights Somente leitura. Anulável.
licenseDetails Coleção delicenseDetails Uma coleção dos detalhes da licença deste 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.)
memberOf Coleção directoryObject Os grupos e as funções de diretório dos quais o usuário é membro. Somente leitura. Anulável.
messages Coleção message As mensagens em uma caixa de correio ou pasta. Somente leitura. Anulável.
onenote onenote Somente leitura.
outlook outlookUser Somente leitura.
ownedDevices Coleção directoryObject Dispositivos que pertencem ao usuário. Somente leitura. Anulável.
ownedObjects Coleção directoryObject Objetos de diretório que pertencem ao usuário. Somente leitura. Anulável.
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 do Planner 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.
todo todo Representa os serviços To Do disponíveis para um usuário.

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",
  "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",
  "preferredLanguage": "string",
  "preferredName": "string",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["string"],
  "responsibilities": ["string"],
  "schools": ["string"],
  "showInAddressList": true,
  "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