Atualizar groupPolicyUploadedDefinition

Namespace: microsoft.graph

Importante: As GRAPH da Microsoft na versão /beta estão sujeitas a alterações; o uso de produção não é suportado.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualize as propriedades de um objeto groupPolicyUploadedDefinition.

Pré-requisitos

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/groupPolicyDefinitions/{groupPolicyDefinitionId}
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/definition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/nextVersionDefinition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/previousVersionDefinition
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/category/definitions/{groupPolicyDefinitionId}
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/definitionFile/definitions/{groupPolicyDefinitionId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto groupPolicyUploadedDefinition.

A tabela a seguir mostra as propriedades que são necessárias ao criar o groupPolicyUploadedDefinition.

Propriedade	Tipo	Descrição
classType	groupPolicyDefinitionClassType	Identifica o tipo de grupos aos qual a política pode ser aplicada. Herdado de groupPolicyDefinition. Os valores possíveis são: user e machine.
displayName	String	O nome da política localizada. Herdado de groupPolicyDefinition
explainText	String	A explicação localizada ou o texto de ajuda associado à política. O valor padrão é vazio. Herdado de groupPolicyDefinition
categoryPath	String	O caminho de categoria completa localizado para a política. Herdado de groupPolicyDefinition
supportedOn	String	Cadeia de caracteres localizada usada para especificar qual versão do sistema operacional ou aplicativo é afetada pela política. Herdado de groupPolicyDefinition
policyType	groupPolicyType	Especifica o tipo de política de grupo. Herdado de groupPolicyDefinition. Os valores possíveis são: admxBacked e admxIngested.
hasRelatedDefinitions	Booliano	Significa se há ou não definições relacionadas a essa definição Herdadas de groupPolicyDefinition
groupPolicyCategoryId	Guid	A id de categoria da categoria pai Herdada de groupPolicyDefinition
minDeviceCspVersion	String	Versão mínima necessária do CSP para configuração do dispositivo nesta definição Herdada de groupPolicyDefinition
minUserCspVersion	String	Versão mínima necessária do CSP para configuração do usuário nesta definição Herdada de groupPolicyDefinition
versão	String	Definindo a versão de definição Herdada de groupPolicyDefinition
id	String	Chave da entidade. Herdado de groupPolicyDefinition
lastModifiedDateTime	DateTimeOffset	A data e a hora em que a entidade foi modificada pela última vez. Herdado de groupPolicyDefinition

Resposta

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto groupPolicyUploadedDefinition atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitions/{groupPolicyDefinitionId}
Content-type: application/json
Content-length: 538

{
  "@odata.type": "#microsoft.graph.groupPolicyUploadedDefinition",
  "classType": "machine",
  "displayName": "Display Name value",
  "explainText": "Explain Text value",
  "categoryPath": "Category Path value",
  "supportedOn": "Supported On value",
  "policyType": "admxIngested",
  "hasRelatedDefinitions": true,
  "groupPolicyCategoryId": "4d1e97a2-97a2-4d1e-a297-1e4da2971e4d",
  "minDeviceCspVersion": "Min Device Csp Version value",
  "minUserCspVersion": "Min User Csp Version value",
  "version": "Version value"
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 651

{
  "@odata.type": "#microsoft.graph.groupPolicyUploadedDefinition",
  "classType": "machine",
  "displayName": "Display Name value",
  "explainText": "Explain Text value",
  "categoryPath": "Category Path value",
  "supportedOn": "Supported On value",
  "policyType": "admxIngested",
  "hasRelatedDefinitions": true,
  "groupPolicyCategoryId": "4d1e97a2-97a2-4d1e-a297-1e4da2971e4d",
  "minDeviceCspVersion": "Min Device Csp Version value",
  "minUserCspVersion": "Min User Csp Version value",
  "version": "Version value",
  "id": "a5f83119-3119-a5f8-1931-f8a51931f8a5",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00"
}