Actualizar groupPolicyDefinitionFile
Espacio de nombres: 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.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto groupPolicyDefinitionFile .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permisos
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.
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | DeviceManagementConfiguration.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
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 solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto groupPolicyDefinitionFile .
En la tabla siguiente se muestran las propiedades necesarias al crear groupPolicyDefinitionFile.
Propiedad | Tipo | Descripción |
---|---|---|
displayName | Cadena | Nombre descriptivo localizado del archivo ADMX. |
description | Cadena | Descripción localizada de la configuración de directiva en el archivo ADMX. De manera predetermina, se deja en blanco. |
languageCodes | Colección de cadenas | Códigos de idioma admitidos para el archivo ADMX. |
targetPrefix | Cadena | Especifica el nombre lógico que hace referencia al espacio de nombres dentro del archivo ADMX. |
Targetnamespace | Cadena | Especifica el URI que se usa para identificar el espacio de nombres dentro del archivo ADMX. |
policyType | groupPolicyType | Especifica el tipo de directiva de grupo. Los valores posibles son admxBacked y admxIngested . |
Revisión | Cadena | Versión de revisión asociada al archivo. |
fileName | Cadena | Nombre de archivo del archivo ADMX sin la ruta de acceso. Por ejemplo: edge.admx |
id | Cadena | Clave de la entidad. |
lastModifiedDateTime | DateTimeOffset | Fecha y hora en que se modificó por última vez la entidad. |
Respuesta
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.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitionFiles/{groupPolicyDefinitionFileId}
Content-type: application/json
Content-length: 392
{
"@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",
"fileName": "File Name value"
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 505
{
"@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",
"fileName": "File Name value",
"id": "940aa2a1-a2a1-940a-a1a2-0a94a1a20a94",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de