Actualizar groupPolicyConfiguration
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 groupPolicyConfiguration .
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/groupPolicyConfigurations/{groupPolicyConfigurationId}
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 groupPolicyConfiguration .
En la tabla siguiente se muestran las propiedades necesarias al crear groupPolicyConfiguration.
Propiedad | Tipo | Descripción |
---|---|---|
createdDateTime | DateTimeOffset | Fecha y hora en que se creó el objeto. |
displayName | Cadena | Nombre proporcionado por el usuario para el objeto de recurso. |
description | Cadena | Descripción proporcionada por el usuario para el objeto de recurso. |
roleScopeTagIds | Colección string | Lista de etiquetas de ámbito para la configuración. |
policyConfigurationIngestionType | groupPolicyConfigurationIngestionType | Tipo de definiciones configuradas para esta directiva. Los valores posibles son: unknown , custom , builtIn , mixed y unknownFutureValue . |
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 groupPolicyConfiguration actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfigurations/{groupPolicyConfigurationId}
Content-type: application/json
Content-length: 256
{
"@odata.type": "#microsoft.graph.groupPolicyConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"policyConfigurationIngestionType": "custom"
}
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: 428
{
"@odata.type": "#microsoft.graph.groupPolicyConfiguration",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"displayName": "Display Name value",
"description": "Description value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"policyConfigurationIngestionType": "custom",
"id": "27b935ec-35ec-27b9-ec35-b927ec35b927",
"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