Actualizar groupPolicyDefinitionFileUpdate groupPolicyDefinitionFile

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante: Las API de Microsoft Graph en la versión/beta están sujetas a cambios; no se admite el uso de producción.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Actualice las propiedades de un objeto groupPolicyDefinitionFile .Update the properties of a groupPolicyDefinitionFile object.

Requisitos previosPrerequisites

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
ApplicationApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitud HTTPHTTP Request

PATCH /deviceManagement/groupPolicyDefinitionFiles/{groupPolicyDefinitionFileId}
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/definitionFile
PATCH /deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}/definitionValues/{groupPolicyDefinitionValueId}/presentationValues/{groupPolicyPresentationValueId}/presentation/definition/category/definitionFile

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto groupPolicyDefinitionFile .In the request body, supply a JSON representation for the groupPolicyDefinitionFile object.

En la tabla siguiente se muestran las propiedades necesarias para crear el groupPolicyDefinitionFile.The following table shows the properties that are required when you create the groupPolicyDefinitionFile.

PropiedadProperty TipoType DescripciónDescription
displayNamedisplayName CadenaString El nombre descriptivo adaptado del archivo ADMX.The localized friendly name of the ADMX file.
descriptiondescription CadenaString La descripción localizada de la configuración de la Directiva en el archivo ADMX.The localized description of the policy settings in the ADMX file. De manera predetermina, se deja en blanco.The default value is empty.
languageCodeslanguageCodes Colección de cadenasString collection Los códigos de idioma admitidos para el archivo ADMX.The supported language codes for the ADMX file.
targetPrefixtargetPrefix CadenaString Especifica el nombre lógico que hace referencia al espacio de nombres dentro del archivo ADMX.Specifies the logical name that refers to the namespace within the ADMX file.
targetNamespacetargetNamespace CadenaString Especifica el URI usado para identificar el espacio de nombres dentro del archivo ADMX.Specifies the URI used to identify the namespace within the ADMX file.
policyTypepolicyType groupPolicyTypegroupPolicyType Especifica el tipo de directiva de grupo.Specifies the type of group policy. Los valores posibles son admxBacked y admxIngested.Possible values are: admxBacked, admxIngested.
corregirevision CadenaString Versión de revisión asociada con el archivo.The revision version associated with the file.
idid CadenaString Clave de la entidad.Key of the entity.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset La fecha y la hora en que se modificó por última vez la entidad.The date and time the entity was last modified.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto groupPolicyDefinitionFile actualizado en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and an updated groupPolicyDefinitionFile object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitionFiles/{groupPolicyDefinitionFileId}
Content-type: application/json
Content-length: 358

{
  "@odata.type": "#microsoft.graph.groupPolicyDefinitionFile",
  "displayName": "Display Name value",
  "description": "Description value",
  "languageCodes": [
    "Language Codes value"
  ],
  "targetPrefix": "Target Prefix value",
  "targetNamespace": "Target Namespace value",
  "policyType": "admxIngested",
  "revision": "Revision value"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.groupPolicyDefinitionFile",
  "displayName": "Display Name value",
  "description": "Description value",
  "languageCodes": [
    "Language Codes value"
  ],
  "targetPrefix": "Target Prefix value",
  "targetNamespace": "Target Namespace value",
  "policyType": "admxIngested",
  "revision": "Revision value",
  "id": "940aa2a1-a2a1-940a-a1a2-0a94a1a20a94",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00"
}