tipo de recurso administrativeUnit

  • Artigo

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Uma unidade administrativa fornece um contêiner conceitual para objetos de diretório de usuário, grupo e dispositivo. Com unidades administrativas, um administrador da empresa agora pode delegar responsabilidades administrativas para gerenciar os usuários, grupos e dispositivos contidos dentro ou no escopo de uma unidade administrativa para um administrador regional ou departamental. Para obter mais informações sobre unidades administrativas, consulte Unidades administrativas em 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 coleção administrativeUnit Listar propriedades de todas as unidades administrativas.
Get administrativeUnit Leia propriedades e relações de um objeto administrativeUnit específico.
Atualizar administrativeUnit Atualizar o objeto administrativeUnit.
Delete Nenhum Excluir objeto administrativeUnit.
Obter delta administrativeUnit Obtenha as unidades administrativas recém-criadas, atualizadas ou excluídas sem precisar executar uma leitura completa de toda a coleção de recursos.
Adicionar um membro directoryObject Adicione um membro (usuário ou grupo).
Listar membros Coleção directoryObject Obtenha a lista de membros (usuário e grupo).
Obter um membro directoryObject Obtenha um membro específico.
Remover um membro directoryObject Remova um membro.
Adicionar um escopodRoleMember scopedRoleMembership Atribua uma função Microsoft Entra com escopo de unidade administrativa.
Escopo de listaRoleMembers Coleção scopedRoleMembership Liste Microsoft Entra atribuições de função com escopo de unidade administrativa.
Obter um escopodRoleMember scopedRoleMembership Obtenha uma atribuição de função Microsoft Entra com escopo de unidade administrativa.
Remover um escopodRoleMember scopedRoleMembership Remova uma atribuição de função Microsoft Entra com escopo de unidade administrativa.
Extensões abertas
Criar extensão aberta openTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obtenha uma extensão aberta identificada pelo nome da extensão.
Extensões de esquema
Adicionar valores de extensões de esquema Cria uma definição para a extensão de esquema e usa-a para adicionar dados digitados personalizados a um recurso.

Observação

O ponto de extremidade da URL para chamar a API administrativeUnits está /administrativeUnits no beta ponto de extremidade, mas /directory/administrativeUnits no ponto de v1.0 extremidade.

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, consulte Recursos avançados de consulta em objetos de diretório.

Propriedade. Tipo Descrição
description Cadeia de caracteres Uma descrição opcional para a unidade administrativa. $filter Dá suporte (eq, , inne, startsWith), $search.
displayName Cadeia de caracteres Nome de exibição da 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 para a unidade administrativa. Somente leitura. Suporta $filter (eq).
isMemberManagementRestricted Booliano true se os membros desta unidade administrativa devem ser tratados como confidenciais, o que requer permissões específicas para gerenciar. O valor padrão é false. Use essa propriedade para definir unidades administrativas cujas funções não herdam de administradores de nível de locatário e o gerenciamento de objetos membros individuais é limitado a administradores com escopo para uma unidade administrativa de gerenciamento restrito. Imutável, portanto, não pode ser alterado mais tarde.

Para obter mais informações sobre como trabalhar com unidades administrativas de gerenciamento restrito, consulte Unidades administrativas de gerenciamento restrito em Microsoft Entra ID.
membershipRule String Regra de associação dinâmica para a unidade administrativa. Para saber mais sobre as regras que você pode usar para unidades administrativas dinâmicas e grupos dinâmicos, consulte Usando atributos para criar regras avançadas.
membershipRuleProcessingState String Usado para controlar se a regra de associação dinâmica é processada ativamente. Defina como On quando quiser que a regra de associação dinâmica esteja ativa e Paused se você quiser parar de atualizar a associação dinamicamente. Se não for definido, o comportamento padrão será Paused.
membershipType Cadeia de caracteres Tipo de associação para a unidade administrativa. Pode ser dynamic ou assigned. Se não for definido, o comportamento padrão será assigned.
visibility Cadeia de caracteres Controla se a unidade administrativa e seus membros estão ocultos ou públicos. Pode ser definido como HiddenMembership ou Public. Se não for definido, o comportamento padrão será Public. Quando definido como HiddenMembership, somente membros da unidade administrativa podem listar outros membros da unidade administrativa.

Dica

Extensões de diretório e dados associados são retornados por padrão, enquanto extensões de esquema e dados associados retornados apenas em $select.

Relações

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

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

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

Conteúdo relacionado