Partilhar via

administrativeUnit tipo de recurso

  • Artigo

Namespace: microsoft.graph

Uma unidade administrativa fornece um contentor conceptual para objetos de diretório de utilizador, grupo e dispositivo. Com as unidades administrativas, um administrador da empresa pode agora delegar responsabilidades administrativas para gerir os utilizadores, grupos e dispositivos contidos dentro ou no âmbito de uma unidade administrativa a um administrador regional ou departamal. Para obter mais informações sobre unidades administrativas, consulte Unidades administrativas no Microsoft Entra ID.

Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas.

Esse recurso permite:

  • Adicionar seus próprios dados às propriedades personalizadas como extensions.
  • Usar a consulta delta para controlar adições, exclusões e atualizações incrementais oferecendo uma função delta.

Métodos

Método Tipo de retorno Descrição
Criar administrativeUnit Create uma nova unidade administrativa.
List administrativeUnit collection Listar propriedades de todos os administrativeUnits.
Get administrativeUnit Ler propriedades e relações de um objeto administrativeUnit específico.
Atualizar administrativeUnit Atualizar o objeto administrativeUnit.
Delete Nenhum Eliminar objeto administrativeUnit.
Adicionar um membro directoryObject Adicionar um membro (utilizador, grupo ou dispositivo).
Listar membros Coleção directoryObject Obtenha a lista de membros (utilizador, grupo ou dispositivo).
Obter um membro directoryObject Obter um membro específico.
Remover um membro directoryObject Remover um membro.
Atribuir uma função com âmbito scopedRoleMembership Atribua uma função de Microsoft Entra com âmbito de unidade administrativa.
Listar atribuições de funções com âmbito Coleção scopedRoleMembership Listar Microsoft Entra atribuições de funções com âmbito de unidade administrativa.
Obter uma atribuição de função com âmbito scopedRoleMembership Obtenha uma atribuição de função Microsoft Entra com o âmbito da unidade administrativa.
Remover uma atribuição de função com âmbito scopedRoleMembership Remova uma atribuição de função Microsoft Entra com o âmbito da unidade administrativa.

Propriedades

Importante

O uso específico de $filter e o parâmetro de consulta $search é suportado somente quando se usa o cabeçalho ConsistencyLevel definido como eventual e $count. Para obter mais informações, veja Capacidades avançadas de consulta em objetos de diretório.

Propriedade Tipo Descrição
description Cadeia de caracteres Uma descrição opcional para a unidade administrativa. $filter Suporta (eq, ne, in, startsWith), $search.
displayName Cadeia de caracteres Nome a apresentar para a unidade administrativa. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores), $search, e $orderby.
id Cadeia de caracteres Identificador exclusivo da unidade administrativa. Somente leitura. Suporta $filter (eq).
visibility Cadeia de caracteres Controla se a unidade administrativa e os respetivos membros estão ocultos ou públicos. Pode ser definido como HiddenMembership. Se não estiver definido (o valor é null), o comportamento predefinido é público. Quando definido como HiddenMembership, apenas os membros da unidade administrativa podem listar outros membros da unidade administrativa.

Dica

As extensões de diretório e os dados associados são devolvidos por predefinição, enquanto as extensões de esquema e os dados associados são devolvidos apenas em $select.

Relações

Relação Tipo Descrição
membros Coleção directoryObject Utilizadores e grupos que são membros desta unidade administrativa. Oferece suporte para $expand.
extensions Coleção extension A coleção de extensões abertas definidas para esta unidade administrativa. Anulável.
scopedRoleMembers Coleção scopedRoleMembership Membros de função de âmbito desta unidade administrativa.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "visibility": "String"
}

Conteúdo relacionado