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. |
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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de