Tipo de recurso educationUser

Namespace: microsoft.graph

Um usuário no sistema. Esta é uma variante específica da educação do utilizador com o mesmo ID que o Microsoft Graph irá devolver do ponto final não específico /users da educação. Este objeto fornece um subconjunto direcionado de propriedades do objeto de utilizador principal e adiciona um conjunto de propriedades específicas da educação, como primaryRole, estudantes e dados do professor .

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
List	Coleção educationUser	Obtenha uma lista dos objetos educationUser e respetivas propriedades.
Create	educationUser	Crie um novo objeto educationUser .
Get	educationUser	Leia as propriedades e relações de um objeto educationUser .
Atualizar	educationUser	Atualize as propriedades de um objeto educationUser .
Delete	Nenhum	Exclua um objeto educationUser.
Obter alterações aos utilizadores	Coleção educationUser	Obter alterações incrementais à coleção de recursos.
Listar turmas lecionadas	Coleção educationClass	Obtenha os recursos educationClass da propriedade de navegação classes ensinadas .

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 utilizador.
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 de onde este 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 correio do utilizador.
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 utilizador.
mobilePhone	String	O número de celular principal do usuário.
officeLocation	String	A localização do escritório para o utilizador.
onPremisesInfo	educationOnPremisesInfo	Informações adicionais utilizadas para associar o utilizador do Microsoft Entra à sua contraparte 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 em conjunto; 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 utilizador 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.
refreshTokensValidFromDateTime	DateTimeOffset	Todos os tokens de atualização ou tokens de sessões (cookies de sessão) emitidos antes desta hora são inválidos e as aplicações recebem um erro ao utilizar um token de atualização ou sessão inválido para adquirir um token de acesso delegado (para aceder a APIs como o Microsoft Graph). Se isto acontecer, a aplicação tem de adquirir um novo token de atualização ao pedir o ponto final autorizado. Retornado apenas em $select. Somente leitura.
relatedContacts	relatedContact collection	Registos relacionados associados ao utilizador. Somente leitura.
residenceAddress	physicalAddress	O endereço onde o utilizador reside.
showInAddressList	Booliano	True se a Lista de Endereços Globais do Outlook deve conter este utilizador; 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 principal for professor, este bloco irá 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 início de sessão ao estilo da Internet para o utilizador 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 tem de estar presente na coleção de domínios verificados do inquilino. Essa propriedade é obrigatória quando um usuário é criado. Os domínios verificados do inquilino podem ser acedidos a partir da 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 utilizar âmbitos de permissão Delegados, o Microsoft Graph só devolverá um conjunto limitado de propriedades: id, primaryRole, accountEnabled, displayName, givenName, apelido, userPrincipalName, userType, onPremisesInfo, student/externalId, professor/externalId. Se a sua aplicação precisar de propriedades adicionais, tem de utilizar os Âmbitos de permissão da aplicação.

Relações

Relação	Tipo	Descrição
assignments	coleção educationAssignment	Atribuições pertencentes ao utilizador.
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.
classes ensinadas	Coleção educationClass	Turmas para as quais o utilizador é professor.
usuário	user	O utilizador do diretório que corresponde a este utilizador.
rubricas	educationRubric collection	Quando definida, a rubrica de classificação anexada à tarefa.

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"
}