tipo de recurso directoryRoleTemplatedirectoryRoleTemplate resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Representa um modelo de função de diretório. Um modelo de função de diretório especifica os valores de propriedade de uma função de diretório (directoryRole). Há um modelo de função de diretório associado para cada uma das funções de diretório que podem ser ativadas em um locatário. Para ler uma função de diretório ou atualizar seus membros, primeiro ela deve ser ativada no locatário. Apenas a função de diretório Administradores de Empresa é ativada por padrão. Para ativar outras funções de diretório disponíveis, você envia uma solicitação POST para o ponto de extremidade /directoryRoles com a ID do modelo de função de diretório no qual se baseia a função directory especificada no parâmetro roleTemplateId da solicitação. Após a conclusão bem-sucedida da solicitação, você pode começar a ler e atribuir membros à função de diretório. Observação: Um modelo de função de diretório é exposto para a função de diretório Usuários. A função de diretório Users está implícita e não é visível para os clientes de diretório. Todos os usuários do locatário são atribuídos a essa função pela infraestrutura. A função já está ativada. Não use este modelo.Represents a directory role template. A directory role template specifies the property values of a directory role (directoryRole). There is an associated directory role template object for each of the directory roles that may be activated in a tenant. To read a directory role or update its members, it must first be activated in the tenant. Only the Company Administrators directory role is activated by default. To activate other available directory roles you send a POST request to the /directoryRoles endpoint with the ID of the directory role template on which the directory role is based specified in the roleTemplateId parameter of the request. Upon successful completion of this request, you can then start to read and assign members to the directory role. Note: A directory role template is exposed for the Users directory role. The Users directory role is implicit and is not visible to directory clients. Every User in the tenant is assigned to this role by the infrastructure. The role is already activated. Do not use this template.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Obter directoryRoleTemplateGet directoryRoleTemplate directoryRoleTemplatedirectoryRoleTemplate Leia as propriedades e os relacionamentos do objeto directoryRoleTemplate.Read properties and relationships of directoryRoleTemplate object.
Listar directoryRoleTemplateList directoryRoleTemplate Coleção directoryRoleTemplatedirectoryRoleTemplate collection Recupere uma lista de objetos directoryRoleTemplate.Retrieve a list of directoryRoleTemplate objects.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
descriptiondescription Cadeia de caracteresString A descrição definida para a função de diretório. Somente leitura.The description to set for the directory role. Read-only.
displayNamedisplayName Cadeia de caracteresString O nome de exibição para definir para a função de diretório. Somente leitura.The display name to set for the directory role. Read-only.
idid Cadeia de caracteresString O identificador exclusivo do modelo. Herdado de directoryObject. Você especifica a id do modelo de função do diretório para a propriedade roleTemplateId na solicitação POST para ativar um directoryRole em um locatário. Chave, Não anulável. Somente leitura.The unique identifier for the template. Inherited from directoryObject. You specify the id of the directory role template for the roleTemplateId property in the POST request activate a directoryRole in a tenant. Key, Not nullable. Read-only.

RelaçõesRelationships

NenhumNone

Representação JSONJSON representation

Veja a seguir uma representação JSON do recursoHere is a JSON representation of the resource

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)"
}