Actualizar groupPolicyDefinition
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 groupPolicyDefinition .
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/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}
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 groupPolicyDefinition .
En la tabla siguiente se muestran las propiedades necesarias al crear groupPolicyDefinition.
Propiedad | Tipo | Descripción |
---|---|---|
classType | groupPolicyDefinitionClassType | Identifica el tipo de grupos a los que se puede aplicar la directiva. Los valores posibles son user y machine . |
displayName | Cadena | Nombre de la directiva localizada. |
explainText | Cadena | Explicación localizada o texto de ayuda asociado a la directiva. De manera predetermina, se deja en blanco. |
categoryPath | Cadena | Ruta de acceso de categoría completa localizada para la directiva. |
supportedOn | Cadena | Cadena localizada que se usa para especificar qué sistema operativo o versión de aplicación se ve afectada por la directiva. |
policyType | groupPolicyType | Especifica el tipo de directiva de grupo. Los valores posibles son admxBacked y admxIngested . |
hasRelatedDefinitions | Booleano | Indica si hay o no definiciones relacionadas con esta definición. |
groupPolicyCategoryId | Guid | Identificador de categoría de la categoría primaria |
minDeviceCspVersion | Cadena | Versión mínima requerida de CSP para la configuración del dispositivo en esta definición |
minUserCspVersion | Cadena | Versión mínima necesaria de CSP para la configuración del usuario en esta definición |
version | Cadena | Configuración de la versión de definición |
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 groupPolicyDefinition actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitions/{groupPolicyDefinitionId}
Content-type: application/json
Content-length: 530
{
"@odata.type": "#microsoft.graph.groupPolicyDefinition",
"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"
}
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: 643
{
"@odata.type": "#microsoft.graph.groupPolicyDefinition",
"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": "f9607947-7947-f960-4779-60f9477960f9",
"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