Tipo de recurso de usuáriouser resource type

Representa uma conta de usuário do Azure AD. Herda de directoryObject.Represents an Azure AD user account. Inherits from directoryObject.

Esse recurso permite:This resource supports:

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Listar usuáriosList users Coleção useruser collection Recuperar uma lista de objetos user.Get a list of user objects.
Criar usuárioCreate user useruser Criar um novo objeto user.Create a new user object.
Obter usuárioGet user useruser Ler propriedades e relações do objeto user.Read properties and relationships of user object.
Atualizar usuárioUpdate user useruser Atualizar o objeto user.Update user object.
Excluir usuárioDelete user NenhumNone Excluir o objeto user.Delete user object.
Listar mensagensList messages Coleção messagemessage collection Obter todas as mensagens na caixa de correio do usuário conectado.Get all the messages in the signed-in user's mailbox.
Criar mensagemCreate message messagemessage Criar uma nova Mensagem postando na coleção messages.Create a new Message by posting to the messages collection.
Listar mailFoldersList mailFolders Coleção mailFoldermailFolder collection Obter o conjunto de pastas de email sob a pasta raiz do usuário conectado.Get the mail folder collection under the root folder of the signed-in user.
Criar MailFolderCreate mailFolder mailFoldermailFolder Criar uma nova MailFolder postando na coleção mailFolders.Create a new MailFolder by posting to the mailFolders collection.
sendMailsendMail NenhumNone Enviar a mensagem especificada no corpo da solicitação.Send the message specified in the request body.
Listar eventosList events Coleção eventevent collection 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.Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Criar eventoCreate event eventoevent Criar um novo Event postando na coleção events.Create a new Event by posting to the events collection.
Listar calendáriosList calendars Coleção calendarcalendar collection Obter uma coleção de objetos Calendar.Get a Calendar object collection.
Criar calendárioCreate calendar calendarcalendar Criar um novo Calendar postando na coleção calendars.Create a new Calendar by posting to the calendars collection.
Listar calendarGroupsList calendarGroups Coleção de CalendarGroupcalendarGroup collection Obter uma coleção de objetos CalendarGroup.Get a CalendarGroup object collection.
Criar calendarGroupCreate calendarGroup calendarGroupcalendarGroup Criar um novo CalendarGroup postando na coleção calendarGroups.Create a new CalendarGroup by posting to the calendarGroups collection.
Listar calendarViewList calendarView Coleção eventevent collection Obter uma coleção de objetos Event.Get a Event object collection.
Listar contatosList contacts Coleção decontatocontact collection Obter uma coleção de contatos da pasta Contatos padrão do usuário conectado.Get a contact collection from the default Contacts folder of the signed-in user.
Criar contatoCreate contact contatocontact Criar um novo Contact postando na coleção contacts.Create a new Contact by posting to the contacts collection.
Listar contactFoldersList contactFolders Coleção de pastadeContatoscontactFolder collection Obter a coleção de pastas de contatos na pasta Contatos padrão do usuário conectado.Get the contact folder collection in the default Contacts folder of the signed-in user.
Criar pastadeContatosCreate contactFolder pastadeContatoscontactFolder Criar uma nova ContactFolder postando na coleção contactFolders.Create a new ContactFolder by posting to the contactFolders collection.
Listar directReportsList directReports Coleção directoryObjectdirectoryObject collection Obter os usuários ou contatos subordinados ao usuário da propriedade de navegação directReports.Get the users and contacts that report to the user from the directReports navigation property.
Listar gerenteList manager directoryObjectdirectoryObject Obter o usuário ou o contato organizacional que é o gerente do usuário da propriedade de navegação do gerente.Get the user or organizational contact that is this user's manager from the manager navigation property.
Atribuir gerenteAssign manager directoryObjectdirectoryObject Atribuir um usuário ou um contato organizacional como o gerente do usuário.Assign a user or an organizational contact as this user's manager.
Listar memberOfList memberOf Coleção directoryObjectdirectoryObject collection Obter os grupos e as funções de diretório dos quais o usuário é membro direto da propriedade de navegação memberOf.Get the groups and directory roles that the user is a direct member of from the memberOf navigation property.
Listar memberOf transitivosList transitive memberOf Coleção directoryObjectdirectoryObject collection Enumera os grupos e as funções de diretório dos quais o usuário é membro.List the groups and directory roles that the user is a member of. Essa operação é transitiva e inclui os grupos dos quais o usuário é membro aninhado.This operation is transitive and includes the groups that the user is a nested member of.
Listar ownedDevicesList ownedDevices Coleção directoryObjectdirectoryObject collection Obter os dispositivos que pertencem ao usuário da propriedade de navegação ownedDevices.Get the devices that are owned by the user from the ownedDevices navigation property.
Listar ownedObjectsList ownedObjects Coleção directoryObjectdirectoryObject collection Obter os objetos directory que pertencem ao usuário da propriedade de navegação ownedObjects.Get the directory objects that are owned by the user from the ownedObjects navigation property.
Listar registeredDevicesList registeredDevices Coleção directoryObjectdirectoryObject collection Obter os dispositivos que estão registrados para o usuário da propriedade de navegação registeredDevices.Get the devices that are retistered for the user from the registeredDevices navigation property.
Listar createdObjectsList createdObjects Coleção directoryObjectdirectoryObject collection Obter os objetos directory criados pelo usuário da propriedade de navegação createdObjects.Get the directory objects created by the user from the createdObjects navigation property.
assignLicenseassignLicense useruser Adicionar ou remover assinaturas para o usuário. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura.Add or remove subscriptions for the user. You can also enable and disable specific plans associated with a subscription.
Listar licenseDetailsList licenseDetails Coleção licenseDetailslicenseDetails collection Obtenha uma coleção de objetos licenseDetails.Get a licenseDetails object collection.
checkMemberGroupscheckMemberGroups Coleção de cadeias de caracteresString collection Verifique se há uma associação em uma lista de grupos. A verificação é transitiva.Check for membership in a list of groups. The check is transitive.
checkMemberObjectscheckMemberObjects Coleção de cadeias de caracteresString collection Verifique se há 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. Essa função é transitiva.The function is transitive.
deltadelta coleção de usuáriosuser collection Obter as alterações incrementais para usuários.Get incremental changes for users.
getMemberGroupsgetMemberGroups Coleção de cadeias de caracteresString collection Retorne todos os grupos dos quais o usuário é membro. A verificação é transitiva.Return all the groups that the user is a member of. The check is transitive.
getMemberObjectsgetMemberObjects Coleção de cadeias de caracteresString collection Retorna todos os grupos e funções de diretório dos quais o usuário é membro. A verificação é transitiva.Return all of the groups and directory roles that the user is a member of. The check is transitive.
reminderViewreminderView Coleção ReminderReminder collection Retorna uma lista de lembretes de calendário nas horas de início e término especificadas.Return a list of calendar reminders within the start and end times specified.
revokeSignInSessionsrevokeSignInSessions NenhumNone 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.Revokes all the user's refresh and session tokens issued to applications, by resetting the signInSessionsValidFromDateTime user property to the current date-time. Força o usuário a entrar novamente nesses aplicativos.This forces the user to sign in to those applications again.
translateExchangeIdstranslateExchangeIds coleção convertIdResultconvertIdResult collection Traduzir os identificadores de recursos relacionados ao Outlook entre formatos.Translate identifiers of Outlook-related resources between formats.
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
aboutMeaboutMe StringString Um campo de entrada de texto em forma livre para o usuário se descrever.A freeform text entry field for the user to describe themselves.
accountEnabledaccountEnabled BoolianoBoolean true se a conta estiver habilitada; caso contrário, false. Essa propriedade é obrigatória quando um usuário é criado. Oferece suporte a $filter.true if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter.
ageGroupageGroup StringString Define a faixa etária do usuário.Sets the age group of the user. Valores permitidos: null, minor, notAdult e adult.Allowed values: null, minor, notAdult and adult. Confira as definições de propriedades da faixa etária legal para obter mais informações.Refer to the legal age group property definitions for further information.
assignedLicensesassignedLicenses Coleção assignedLicenseassignedLicense collection As licenças que são atribuídas ao usuário. Não anulável.The licenses that are assigned to the user. Not nullable.
assignedPlansassignedPlans Coleção assignedPlanassignedPlan collection Os planos que são atribuídos ao usuário. Somente leitura. Não anulável.The plans that are assigned to the user. Read-only. Not nullable.
birthdaybirthday DateTimeOffsetDateTimeOffset 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 em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
businessPhonesbusinessPhones String collectionString collection Números de telefone para o usuário. OBSERVAÇÃO: Embora isso seja uma coleção de cadeias de caracteres, somente um número pode ser definido para essa propriedade.The telephone numbers for the user. NOTE: Although this is a string collection, only one number can be set for this property.
citycity StringString A cidade em que o usuário está localizado. Oferece suporte a $filter.The city in which the user is located. Supports $filter.
companyNamecompanyName StringString O nome da empresa em que o usuário está associado.The company name which the user is associated. Essa propriedade pode ser útil para descrever a empresa de onde procede um usuário externo.This property can be useful for describing the company that an external user comes from.
consentProvidedForMinorconsentProvidedForMinor StringString Define se o consentimento foi obtido para menores.Sets whether consent has been obtained for minors. Valores permitidos: null, granted, denied e notRequired.Allowed values: null, granted, denied and notRequired. Confira as definições de propriedades da faixa etária legal para obter mais informações.Refer to the legal age group property definitions for further information.
countrycountry StringString O país/região em que o usuário está localizado. Por exemplo, "EUA" ou "Reino Unido". Oferece suporte a $filter.The country/region in which the user is located; for example, “US” or “UK”. Supports $filter.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Data de criação do objeto do usuário.The created date of the user object.
departmentdepartment StringString O nome do departamento no qual o usuário trabalha. Oferece suporte a $filter.The name for the department in which the user works. Supports $filter.
displayNamedisplayName StringString O nome exibido no catálogo de endereços do usuário. É 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. Oferece suporte a $filter e $orderby.The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Supports $filter and $orderby.
employeeIdemployeeId StringString O identificador de funcionário atribuído ao usuário pela organização.The employee identifier assigned to the user by the organization. Com suporte para $filter.Supports $filter.
faxNumberfaxNumber StringString O número de fax do usuário.The fax number of the user.
givenNamegivenName StringString O nome fornecido (nome) do usuário. Oferece suporte a $filter.The given name (first name) of the user. Supports $filter.
hireDatehireDate DateTimeOffsetDateTimeOffset 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 em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
idid StringString O identificador exclusivo do usuário. Herdado de directoryObject. Chave. Não anulável. Somente leitura.The unique identifier for the user. Inherited from directoryObject. Key. Not nullable. Read-only.
imAddressesimAddresses String collectionString 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.The instant message voice over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only.
interestsinterests Coleção de cadeias de caracteresString collection Uma lista para o usuário descrever os interesses dele.A list for the user to describe their interests.
isResourceAccountisResourceAccount BoolianoBoolean Verdadeiro se o usuário é uma conta de recursos; caso contrário, falso.true if the user is a resource account; otherwise, false. O valor nulo deve ser considerado falso.Null value should be considered false.
jobTitlejobTitle StringString O cargo do usuário. Oferece suporte a $filter.The user’s job title. Supports $filter.
lastPasswordChangeDateTimelastPasswordChangeDateTime DateTimeOffsetDateTimeOffset A hora em que o usuário do Azure AD alterou a senha dele pela última vez.The time when this Azure AD user last changed their password. As informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC.The date and time information uses 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'
legalAgeGroupClassificationlegalAgeGroupClassification StringString Usado por aplicativos empresariais para determinar a faixa etária legal do usuário.Used by enterprise applications to determine the legal age group of the user. Essa propriedade é somente leitura e calculada com base nas propriedades ageGroup e consentProvidedForMinor.This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Valores permitidos: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult e adult.Allowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. Confira as definições de propriedades da faixa etária legal para obter mais informações.Refer to the legal age group property definitions for further information.)
licenseAssignmentStateslicenseAssignmentStates Coleção licenseAssignmentStatelicenseAssignmentState collection Estado das atribuições de licenças para esse usuário.State of license assignments for this user. Somente leitura.Read-only.
emailmail StringString O endereço SMTP do usuário, por exemplo, "jeff@contoso.onmicrosoft.com". Somente Leitura. Oferece suporte a $filter.The SMTP address for the user, for example, "jeff@contoso.onmicrosoft.com". Read-Only. Supports $filter.
mailboxSettingsmailboxSettings mailboxSettingsmailboxSettings 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.Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale and time zone.
mailNicknamemailNickname StringString O alias de email do usuário. Essa propriedade deve ser especificada quando um usuário é criado. Oferece suporte a $filter.The mail alias for the user. This property must be specified when a user is created. Supports $filter.
mobilePhonemobilePhone StringString O número de celular principal do usuário.The primary cellular telephone number for the user.
mySitemySite StringString A URL do site pessoal do usuário.The URL for the user's personal site.
officeLocationofficeLocation StringString A localização do escritório no local de trabalho do usuário.The office location in the user's place of business.
onPremisesDistinguishedNameonPremisesDistinguishedName StringString Contém o distinguished name do Active Directory no local ou DN.Contains the on-premises Active Directory distinguished name or DN. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Somente leitura.Read-only.
onPremisesDomainNameonPremisesDomainName StringString Contém o domainFQDN local, também chamado dnsDomainName sincronizado do diretório local.Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Somente leitura.Read-only.
onPremisesExtensionAttributesonPremisesExtensionAttributes onPremisesExtensionAttributesonPremisesExtensionAttributes Contém extensionAttributes 1-15 para o usuário.Contains extensionAttributes 1-15 for the user. Observe que os atributos de extensão individuais não são selecionáveis nem filtráveis.Note that the individual extension attributes are neither selectable nor filterable. Para um usuário onPremisesSyncEnabled, esse conjunto de propriedades é masterizado no local e somente leitura.For an onPremisesSyncEnabled user, this set of properties is mastered on-premises and is read-only. Para um usuário somente na nuvem (onde onPremisesSyncEnabled é falso), essas propriedades podem ser definidas durante a criação ou atualização.For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update.
onPremisesImmutableIdonPremisesImmutableId StringString Essa propriedade é usada para associar uma conta de usuário do Active Directory local com seu objeto de usuário do Azure AD.This property is used to associate an on-premises Active Directory user account to their Azure AD user object. Esta propriedade deverá 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) do usuário.This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user’s userPrincipalName (UPN) property. Importante: Os caracteres $ e _ não podem ser usados ao especificar esta propriedade.Important: The $ and _ characters cannot be used when specifying this property. Oferece suporte a $filter.Supports $filter.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset 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 em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Somente leitura.Indicates the last time at which the object was synced with the on-premises directory; for example: "2013-02-16T03:04:54Z". The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only.
onPremisesProvisioningErrorsonPremisesProvisioningErrors coleção OnPremisesProvisioningErroronPremisesProvisioningError collection Erros ao usar o produto de sincronização da Microsoft durante o provisionamento.Errors when using Microsoft synchronization product during provisioning.
onPremisesSamAccountNameonPremisesSamAccountName StringString Contém o samAccountName local sincronizado no diretório local.Contains the on-premises samAccountName synchronized from the on-premises directory. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Somente leitura.Read-only.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier StringString Contém o identificador de segurança (SID) local do usuário que foi sincronizado do local com a nuvem. Somente leitura.Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BoolianoBoolean 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 leituratrue 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). Read-only
onPremisesUserPrincipalNameonPremisesUserPrincipalName StringString Contém o userPrincipalName local sincronizado no diretório local.Contains the on-premises userPrincipalName synchronized from the on-premises directory. A propriedade somente é preenchida para os clientes que estejam sincronizando o seu diretório local ao Azure Active Directory pelo Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Somente leitura.Read-only.
otherMailsotherMails StringString Uma lista de endereços de email adicional para o usuário; Por exemplo: ["bob@contoso.com", "Robert@fabrikam.com"].A list of additional email addresses for the user; for example: ["bob@contoso.com", "Robert@fabrikam.com"]. Oferece suporte a $filter.Supports $filter.
passwordPoliciespasswordPolicies StringString Especifica as políticas de senha do usuário. Esse valor é uma enumeração cujo um dos valores possíveis é "DisableStrongPassword", o que permite especificar senhas mais fracas do que a política padrão. Também é possível especificar "DisablePasswordExpiration". Ambos podem ser especificados juntos; por exemplo: "DisablePasswordExpiration, DisableStrongPassword".Specifies password policies for the user. This value is an enumeration with one possible value being “DisableStrongPassword”, which allows weaker passwords than the default policy to be specified. “DisablePasswordExpiration” can also be specified. The two may be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile passwordProfilepasswordProfile 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.Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
pastProjectspastProjects Coleção de cadeias de caracteresString collection Uma lista para o usuário enumerar seus projetos anteriores.A list for the user to enumerate their past projects.
postalCodepostalCode StringString 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.The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.
preferredDataLocationpreferredDataLocation StringString O local de dados preferido para o usuário.The preferred data location for the user. Para saber mais, confira OneDrive Online Multi-Geo.For more information, see OneDrive Online Multi-Geo.
preferredLanguagepreferredLanguage StringString O idioma preferencial do usuário. Deve seguir o código ISO 639-1; por exemplo "en-US".The preferred language for the user. Should follow ISO 639-1 Code; for example "en-US".
preferredNamepreferredName StringString O nome preferencial do usuário.The preferred name for the user.
provisionedPlansprovisionedPlans coleção provisionedPlanprovisionedPlan collection Os planos que estão provisionados para o usuário. Somente leitura. Não anulável.The plans that are provisioned for the user. Read-only. Not nullable.
proxyAddressesproxyAddresses Coleção de cadeias de caracteresString collection Por exemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] O operador any é obrigatório para expressões de filtro em propriedades de vários valores. Somente leitura, não anulável. Oferece suporte a $filter.For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] The any operator is required for filter expressions on multi-valued properties. Read-only, Not nullable. Supports $filter.
responsibilitiesresponsibilities Coleção de cadeias de caracteresString collection Uma lista para o usuário enumerar suas responsabilidades.A list for the user to enumerate their responsibilities.
schoolsschools Coleção de cadeias de caracteresString collection Uma lista para o usuário enumerar as escolas que frequentou.A list for the user to enumerate the schools they have attended.
showInAddressListshowInAddressList BoolianoBoolean true se a lista de endereços global do Outlook deve conter o usuário, caso contrário false.true if the Outlook global address list should contain this user, otherwise false. Se não estiver configurado, isso será tratado como true.If not set, this will be treated as true. Para os usuários convidados por meio do Gerenciador de convites, essa propriedade será definida como false.For users invited through the invitation manager, this property will be set to false.
skillsskills Coleção de cadeias de caracteresString collection Uma lista para o usuário enumerar suas qualificações.A list for the user to enumerate their skills.
signInSessionsValidFromDateTimesignInSessionsValidFromDateTime DateTimeOffsetDateTimeOffset 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).Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications will get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as 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.If this happens, the application will need to acquire a new refresh token by making a request to the authorize endpoint. Somente leitura.Read-only. Use revokeSignInSessions para redefinir.Use revokeSignInSessions to reset.
statestate StringString O estado ou município no endereço do usuário. Oferece suporte a $filter.The state or province in the user's address. Supports $filter.
streetAddressstreetAddress StringString O endereço do local de trabalho do usuário.The street address of the user's place of business.
surnamesurname StringString O sobrenome do usuário (nome de família ou sobrenome). Oferece suporte a $filter.The user's surname (family name or last name). Supports $filter.
usageLocationusageLocation StringString 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. Entre os exemplos temos: "US", "JP" e "GB". Não anulável. Oferece suporte a $filter.A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: "US", "JP", and "GB". Not nullable. Supports $filter.
userPrincipalNameuserPrincipalName StringString 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, em que o domínio deve estar presente na coleção de domínios verificados do 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. Oferece suporte a $filter e $orderby.The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby.
userTypeuserType StringString Um valor de cadeia de caracteres que pode ser usado para classificar tipos de usuários no seu diretório, como “Member” e “Guest”. Oferece suporte a $filter.A string value that can be used to classify user types in your directory, such as “Member” and “Guest”. Supports $filter.

Esta seção explica como as três propriedades de faixa etária (legalAgeGroupClassification, ageGroup e consentProvidedForMinor) são usadas pelos administradores do Azure AD e desenvolvedores de aplicativos empresariais para atender às normas de idade.This section explains how the three age group properties (legalAgeGroupClassification, ageGroup and consentProvidedForMinor) are used by Azure AD administrators and enterprise application developers to meet age-related regulations.

Por exemplo: Cameron é o administrador de um diretório em uma escola de ensino fundamental em Holyport, no Reino Unido.For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. 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.At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. O consentimento obtido do pai permite que a conta do menor seja usado pela escola de Holyport e os aplicativos da Microsoft.The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. Cameron cria todas as contas e define o ageGroup para "menor" e consentProvidedForMinor para "concedido".Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". Os aplicativos usados por seus alunos poderão, então suprimir recursos que não são adequados para menores.Applications used by his students are then able to suppress features that are not suitable for minors.

Essa propriedade de somente leitura é usada por desenvolvedores de aplicativos empresariais para garantir a manipulação correta do usuário com base em sua faixa etária legal.This read-only property is used by enterprise application developers to ensure the correct handling of a user based on their legal age group. É calculada com base nas propriedades de ageGroup e consentProvidedForMinor do usuário.It is calculated based on the user's ageGroup and consentProvidedForMinor properties.

ValorValue # DescriçãoDescription
nullnull 00 Valor padrão, nenhum ageGroup foi definido para o usuário.Default value, no ageGroup has been set for the user.
minorWithoutParentalConsentminorWithoutParentalConsent 11 (Reservado para uso futuro)(Reserved for future use)
minorWithParentalConsentminorWithParentalConsent 22 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.The user is considered a minor based on the age-related regulations of their country or region and the administrator of the account has obtained appropriate consent from a parent or guardian.
adultadult 33 O usuário é considerado adulto baseado nos regulamentos relacionadas com a idade do seu país ou região.The user considered an adult based on the age-related regulations of their country or region.
notAdultnotAdult 44 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).The user is from a country or region that has additional age-related regulations (such as the United States, United Kingdom, European Union or South Korea), and the user's age is between a minor and an adult age (as stipulated based on country or region). Em geral, isso significa que adolescentes são considerados como notAdult em países regulamentados.Generally, this means that teenagers are considered as notAdult in regulated countries.
minorNoParentalConsentRequiredminorNoParentalConsentRequired 55 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.The user is a minor but is from a country or region that has no age-related regulations.

As propriedades de faixa etária e consentimento de menor são propriedades opcionais usadas por administradores do Azure AD para garantir que o uso da conta é tratado corretamente com base nas regras de regulamentação relacionadas à idade que regem o país ou a região do usuário.The age group and minor consent properties are optional properties used by Azure AD administrators to help ensure the use of an account is handled correctly based on the age-related regulatory rules governing the user's country or region.

propriedade ageGroupageGroup property

ValorValue # DescriçãoDescription
nullnull 00 Valor padrão, nenhum ageGroup foi definido para o usuário.Default value, no ageGroup has been set for the user.
minorminor 11 O usuário é considerado menor de idade.The user is consider a minor.
notAdultnotAdult 22 O usuário é de um país que têm regulamentações estatutárias (Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do usuário é maior do que o limite de idade para criança (conforme o país) e menor que o limite inferior de idade para adulto (como estipulado com base no país ou região).The user is from a country that has statutory regulations United States, United Kingdom, European Union or South Korea) and user’s age is more than the upper limit of kid age (as per country) and less than lower limit of adult age (as stipulated based on country or region). Basicamente, adolescentes são considerados como notAdult em países regulamentados.So basically, teenagers are considered as notAdult in regulated countries.
adultadult 33 O usuário deve ser tratado como um adulto.The user should be a treated as an adult.

Propriedade consentProvidedForMinorconsentProvidedForMinor property

ValorValue # DescriçãoDescription
nullnull 00 Valor padrão, nenhum consentProvidedForMinor foi definido para o usuário.Default value, no consentProvidedForMinor has been set for the user.
grantedgranted 11 O consentimento foi obtido para o usuário ter uma conta.Consent has been obtained for the user to have an account.
denieddenied 22 O consentimento não foi obtido para o usuário ter uma conta.Consent has not been obtained for the user to have an account.
notRequirednotRequired 33 O usuário é de um local que não exige consentimento.The user is from a location that does not require consent.

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
activitiesactivities Coleção userActivityuserActivity collection Atividades do usuário em vários dispositivos.The user's activities across devices. Somente leitura.Read-only. Anulável.Nullable.
calendarcalendar calendarcalendar O calendário principal do usuário. Somente leitura.The user's primary calendar. Read-only.
calendarGroupscalendarGroups Coleção CalendarGroupcalendarGroup collection Os grupos de calendários do usuário. Somente leitura. Anulável.The user's calendar groups. Read-only. Nullable.
calendarViewcalendarView Coleção eventevent collection O modo de exibição do calendário. Somente leitura. Anulável.The calendar view for the calendar. Read-only. Nullable.
calendarscalendars Coleção calendarcalendar collection Os calendários do usuário. Somente leitura. Anulável.The user's calendars. Read-only. Nullable.
contactFolderscontactFolders Coleção ContactFoldercontactFolder collection As pastas de contatos do usuário. Somente leitura. Anulável.The user's contacts folders. Read-only. Nullable.
contactscontacts Coleção Contactcontact collection Os contatos do usuário. Somente leitura. Anulável.The user's contacts. Read-only. Nullable.
createdObjectscreatedObjects Coleção directoryObjectdirectoryObject collection Objetos directory que foram criados pelo usuário. Somente leitura. Anulável.Directory objects that were created by the user. Read-only. Nullable.
directReportsdirectReports Coleção directoryObjectdirectoryObject collection 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.The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable.
drivedrive drivedrive O OneDrive do usuário. Somente leitura.The user's OneDrive. Read-only.
unidadesdrives Coleção drivedrive collection Uma coleção de unidades disponíveis para este usuário. Somente leitura.A collection of drives available for this user. Read-only.
eventosevents Coleção eventevent collection Os eventos do usuário. O padrão é mostrar eventos no Calendário Padrão. Somente leitura. Anulável.The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable.
extensionsextensions extension collectionextension collection A coleção de extensões abertas definidas para o usuário. Somente leitura. Anulável.The collection of open extensions defined for the user. Read-only. Nullable.
inferenceClassificationinferenceClassification inferenceClassificationinferenceClassification 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 inferidas.Relevance classification of the user's messages based on explicit designations which override inferred relevance or importance.
licenseDetailslicenseDetails Coleção delicenseDetailslicenseDetails collection Uma coleção de detalhes da licença do usuário.A collection of this user's license details. Somente leitura.Read-only.
mailFoldersmailFolders Coleção mailFoldermailFolder collection As pastas de email do usuário. Somente leitura. Anulável.The user's mail folders. Read-only. Nullable.
managermanager directoryObjectdirectoryObject O usuário ou contato que é o gerente do usuário. Somente leitura. (Métodos HTTP: GET, PUT, DELETE.)The user or contact that is this user’s manager. Read-only. (HTTP Methods: GET, PUT, DELETE.)
memberOfmemberOf Coleção directoryObjectdirectoryObject collection Os grupos e as funções de diretório dos quais o usuário é membro. Somente leitura. Anulável.The groups and directory roles that the user is a member of. Read-only. Nullable.
messagesmessages Coleção messagemessage collection As mensagens em uma caixa de correio ou pasta. Somente leitura. Anulável.The messages in a mailbox or folder. Read-only. Nullable.
onenoteonenote onenoteonenote Somente leitura.Read-only.
outlookoutlook outlookUseroutlookUser Somente leitura.Read-only.
ownedDevicesownedDevices Coleção directoryObjectdirectoryObject collection Dispositivos que pertencem ao usuário. Somente leitura. Anulável.Devices that are owned by the user. Read-only. Nullable.
ownedObjectsownedObjects Coleção directoryObjectdirectoryObject collection Objetos de diretório que pertencem ao usuário. Somente leitura. Anulável.Directory objects that are owned by the user. Read-only. Nullable.
peoplepeople Coleção personperson collection Pessoas que são relevantes para o usuário.People that are relevant to the user. Somente leitura.Read-only. Anulável.Nullable.
photophoto profilePhotoprofilePhoto A foto de perfil do usuário. Somente leitura.The user's profile photo. Read-only.
plannerplanner plannerUserplannerUser Ponto de entrada para o recurso Planejador que pode existir para um usuário.Entry-point to the Planner resource that might exist for a user. Somente leitura.Read-only.
registeredDevicesregisteredDevices Coleção directoryObjectdirectoryObject collection Dispositivos que estão registrados para o usuário. Somente leitura. Anulável.Devices that are registered for the user. Read-only. Nullable.

Representação JSONJSON representation

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

{
  "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",
  "department": "string",
  "displayName": "string",
  "employeeId": "string",
  "faxNumber" : "string",
  "givenName": "string",
  "hireDate": "String (timestamp)",
  "id": "string (identifier)",
  "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"],
  "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émSee also