Creación de deviceComplianceScript

  • Artículo

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.

Cree un nuevo objeto deviceComplianceScript .

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, DeviceManagementManagedDevices.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitud HTTP

POST /deviceManagement/deviceComplianceScripts

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 deviceComplianceScript.

En la tabla siguiente se muestran las propiedades necesarias al crear deviceComplianceScript.

Propiedad Tipo Descripción
id Cadena Identificador único del script de cumplimiento del dispositivo
publisher Cadena Nombre del publicador de scripts de cumplimiento de dispositivos
version Cadena Versión del script de cumplimiento del dispositivo
displayName Cadena Nombre del script de cumplimiento del dispositivo
description Cadena Descripción del script de cumplimiento del dispositivo
detectionScriptContent Binario Todo el contenido del script de PowerShell de detección
createdDateTime DateTimeOffset Marca de tiempo de cuándo se creó el script de cumplimiento del dispositivo. Esta propiedad es de sólo lectura.
lastModifiedDateTime DateTimeOffset Marca de tiempo de cuando se modificó el script de cumplimiento del dispositivo. Esta propiedad es de sólo lectura.
runAsAccount runAsAccountType Indica el tipo de contexto de ejecución. Los valores posibles son system y user.
enforceSignatureCheck Booleano Indicar si es necesario comprobar la firma del script
runAs32Bit Booleano Indicar si los scripts de PowerShell deben ejecutarse como de 32 bits
roleScopeTagIds Colección de cadenas Lista de identificadores de etiqueta de ámbito para el script de cumplimiento de dispositivos

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto deviceComplianceScript en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/deviceManagement/deviceComplianceScripts
Content-type: application/json
Content-length: 420

{
  "@odata.type": "#microsoft.graph.deviceComplianceScript",
  "publisher": "Publisher value",
  "version": "Version value",
  "displayName": "Display Name value",
  "description": "Description value",
  "detectionScriptContent": "ZGV0ZWN0aW9uU2NyaXB0Q29udGVudA==",
  "runAsAccount": "user",
  "enforceSignatureCheck": true,
  "runAs32Bit": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids 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 201 Created
Content-Type: application/json
Content-Length: 592

{
  "@odata.type": "#microsoft.graph.deviceComplianceScript",
  "id": "14e72a7b-2a7b-14e7-7b2a-e7147b2ae714",
  "publisher": "Publisher value",
  "version": "Version value",
  "displayName": "Display Name value",
  "description": "Description value",
  "detectionScriptContent": "ZGV0ZWN0aW9uU2NyaXB0Q29udGVudA==",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "runAsAccount": "user",
  "enforceSignatureCheck": true,
  "runAs32Bit": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}