Partilhar via


tipo de recurso directorySetting

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.

As definições de diretório definem as configurações que podem ser utilizadas para personalizar as restrições específicas do inquilino e do objeto e o comportamento permitido. Por exemplo, pode bloquear listas de palavras para nomes a apresentar de grupos ou definir se os convidados podem ser proprietários de grupos.

Por predefinição, todas as entidades herdam as predefinições predefinidas. Para alterar as predefinições, tem de criar um novo objeto de definições com o diretórioSettingTemplates. Quando a mesma definição é definida tanto no inquilino como num grupo específico, a definição ao nível da entidade substitui a definição ao nível do inquilino. Por exemplo, a definição ao nível do inquilino pode permitir que os membros de grupos existentes convidem convidados; mas uma definição de grupo individual pode substituir e não permitir a operação.

As definições específicas do grupo aplicam-se apenas a grupos do Microsoft 365.

Dica

A /v1.0 versão deste recurso tem o nome groupSetting.

Métodos

Método Tipo de retorno Descrição
List conjunto directorySetting Lista propriedades de todos os objetos de configuração.
Create directorySetting Crie um objeto de definição com base num diretórioDefiniçãoTemplata.
Get directorySetting Ler propriedades de um objeto de configuração específico.
Atualizar directorySetting Atualizar um objeto setting. Apenas settingValues pode ser alterado numa atualização.
Delete Nenhum Excluir um objeto de configuração.

Propriedades

Propriedade Tipo Descrição
displayName string Nome a apresentar deste grupo de definições, que provém do modelo associado. Somente leitura.
id cadeia de caracteres Identificador exclusivo para estas definições. Somente leitura.
templateId string Identificador exclusivo do modelo utilizado para criar este grupo de definições. Somente leitura.
values settingValue collection Coleção de pares nome-valor correspondente ao nome e propriedades defaultValue no objeto directorySettingTemplates referenciado.

Relações

Nenhum

Representação JSON

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

{
  "displayName": "string",
  "id": "string (identifier)",
  "templateId": "string",
  "values": [{"@odata.type": "microsoft.graph.settingValue"}]
}