Tipo de recurso educationUser

Namespace: microsoft.graph

Um usuário no sistema. Essa é uma variante específica do usuário com a mesma id que o Microsoft Graph retornará do ponto de extremidade não específico /users da educação. Esse objeto fornece um subconjunto de propriedades direcionadas do objeto principal do usuário e adiciona um conjunto de propriedades específicas da educação, como primaryRole, alunos e dados de professor .

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
Listar educationUsers	Coleção educationUser	Obtenha uma lista dos objetos educationUser e suas propriedades.
Criar educationUser	educationUser	Crie um novo objeto educationUser .
Obter educationUser	educationUser	Leia as propriedades e as relações de um objeto educationUser .
Atualizar educationUser	educationUser	Atualize as propriedades de um objeto educationUser .
Excluir educationUser	Nenhum	Exclua um objeto educationUser.
delta	Coleção educationUser	Obtenha alterações incrementais na coleção de recursos.
Lista taughtClasses	Coleção educationClass	Obtenha os recursos educationClass da propriedade de navegação taughtClasses .

Propriedades

Propriedade	Tipo	Descrição
accountEnabled	Booliano	True se a conta estiver habilitada; caso contrário, false. Essa propriedade é obrigatória quando um usuário é criado. Oferece suporte para $filter.
assignedLicenses	Coleção assignedLicense	As licenças que são atribuídas ao usuário. Não anulável.
assignedPlans	Coleção assignedPlan	Os planos que são atribuídos ao usuário. Somente leitura. Não anulável.
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.
createdBy	identitySet	A entidade que criou o usuário.
department	String	O nome do departamento no qual o usuário trabalha. Oferece suporte para $filter.
displayName	String	O nome exibido para o usuário no catálogo de endereços. Geralmente é a combinação do nome, da inicial do nome 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 para $filter e $orderby.
externalSource	educationExternalSource	De onde esse usuário foi criado. Os valores possíveis são: sis e manual.
externalSourceDetail	Cadeia de caracteres	O nome da origem externa da qual esse recurso foi gerado.
givenName	String	O nome fornecido (nome) do usuário. Oferece suporte para $filter.
id	Cadeia de caracteres	Identificador de objeto. Herdado da entidade.
email	String	O endereço SMTP do usuário, por exemplo, jeff@contoso.com. Somente Leitura. Oferece suporte para $filter.
mailingAddress	physicalAddress	O endereço de email do usuário.
mailNickname	String	O alias de email do usuário. Essa propriedade deve ser especificada quando um usuário é criado. Oferece suporte para $filter.
middleName	String	O nome do meio do usuário.
mobilePhone	String	O número de celular principal do usuário.
onPremisesInfo	educationOnPremisesInfo	Informações adicionais usadas para associar o usuário Microsoft Entra ao seu equivalente do Active Directory.
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.
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.
preferredLanguage	Cadeia de caracteres	O idioma preferencial para o usuário que deve seguir o código ISO 639-1, por exemplo, en-US.
primaryRole	educationUserRole	Função padrão de um usuário. A função do usuário pode ser diferente em uma aula individual. Os valores possíveis são: student, teacher, none, unknownFutureValue.
provisionedPlans	coleção provisionedPlan	Os planos que estão provisionados para o usuário. Somente leitura. Não anulável.
relatedContacts	coleção relatedContact	Registros relacionados associados ao usuário. Somente leitura.
residenceAddress	physicalAddress	O endereço em que o usuário mora.
showInAddressList	Booliano	True se a Lista de Endereços Global do Outlook deve conter esse 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.
student	educationStudent	Se a função principal for aluno, esse bloco conterá dados específicos do aluno.
surname	String	O sobrenome do usuário (nome de família ou sobrenome). Oferece suporte para $filter.
teacher	educationTeacher	Se a função primária for professora, esse bloco conterá dados específicos do professor.
usageLocation	Cadeia de caracteres	Um código de país 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 em países ou regiões. Os exemplos incluem:US,JP e GB. Não anulável. Oferece suporte para $filter.
userPrincipalName	String	O nome UPN do usuário. O UPN é um nome de logon no estilo da 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, 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 na propriedade verifiedDomains da organização. Oferece suporte para $filter 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. Oferece suporte para $filter.

Importante

Ao usar escopos de permissão delegados, o Microsoft Graph retornará apenas um conjunto limitado de propriedades: id, primaryRole, accountEnabled, displayName, givenName, sobrenome, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Se seu aplicativo exigir propriedades adicionais, você deve usar escopos de permissão do aplicativo.

Relações

Relação	Tipo	Descrição
assignments	coleção educationAssignment	Atribuições pertencentes ao usuário.
classes	Coleção educationClass	Aulas às quais o usuário pertence. Anulável.
schools	Coleção educationSchool	Escolas às quais o usuário pertence. Anulável.
taughtClasses	Coleção educationClass	Classes para as quais o usuário é professor.
usuário	user	O usuário do diretório que corresponde a esse usuário.
Rubricas	coleção educationRubric	Quando definido, a rubrica de classificação anexada à atribuição.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.educationUser",
  "accountEnabled": "Boolean",
  "assignedLicenses": [
    {
      "@odata.type": "microsoft.graph.assignedLicense"
    }
  ],
  "assignedPlans": [
    {
      "@odata.type": "microsoft.graph.assignedPlan"
    }
  ],
  "businessPhones": ["String"],
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "department": "String",
  "displayName": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "givenName": "String",
  "id": "String (identifier)",
  "mail": "String",
  "mailingAddress": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "mailNickname": "String",
  "middleName": "String",
  "mobilePhone": "String",
  "officeLocation": "String",
  "onPremisesInfo": {
    "@odata.type": "microsoft.graph.educationOnPremisesInfo"
  },
  "passwordPolicies": "String",
  "passwordProfile": {
    "@odata.type": "microsoft.graph.passwordProfile"
  },
  "preferredLanguage": "String",
  "primaryRole": "String",
  "provisionedPlans": [
    {
      "@odata.type": "microsoft.graph.provisionedPlan"
    }
  ],
  "refreshTokensValidFromDateTime": "String (timestamp)",
  "residenceAddress": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "showInAddressList": "Boolean",
  "student": {
    "@odata.type": "microsoft.graph.educationStudent"
  },
  "surname": "String",
  "teacher": {
    "@odata.type": "microsoft.graph.educationTeacher"
  },
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String"
}