Criar deviceHealthScript

Namespace: microsoft.graph

Importante: A Microsoft dá suporte a APIs /beta do Intune, mas elas estão sujeitas a alterações mais frequentes. A Microsoft recomenda usar a versão v1.0 sempre que possível. Verifique a disponibilidade de uma API na versão v1.0 usando o seletor de versão.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto deviceHealthScript .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementScripts.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementScripts.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/deviceHealthScripts

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON para o objeto deviceHealthScript.

A tabela a seguir mostra as propriedades necessárias ao criar o deviceHealthScript.

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador exclusivo para o script de integridade do dispositivo
publicador Cadeia de caracteres Nome do editor do script de integridade do dispositivo
versão Cadeia de caracteres Versão do script de integridade do dispositivo
displayName Cadeia de caracteres Nome do script de integridade do dispositivo
description Cadeia de caracteres Descrição do script de integridade do dispositivo
detectionScriptContent Binária Todo o conteúdo do script do PowerShell de detecção
remediationScriptContent Binária Todo o conteúdo do script do PowerShell de correção
createdDateTime DateTimeOffset O carimbo de data/hora de quando o script de integridade do dispositivo foi criado. Essa propriedade é somente leitura.
lastModifiedDateTime DateTimeOffset O carimbo de data/hora de quando o script de integridade do dispositivo foi modificado. Essa propriedade é somente leitura.
runAsAccount runAsAccountType Indica o tipo de contexto de execução. Os valores possíveis são: system e user.
enforceSignatureCheck Booliano Indique se a assinatura do script precisa ser verificada
runAs32Bit Booliano Indique se os scripts do PowerShell devem ser executados como 32 bits
roleScopeTagIds String collection Lista de IDs de marca de escopo para o script de integridade do dispositivo
isGlobalScript Booliano Determina se este é um script proprietário da Microsoft. Scripts proprietários são somente leitura
highestAvailableVersion Cadeia de caracteres A versão mais alta disponível para um script proprietário da Microsoft
deviceHealthScriptType deviceHealthScriptType DeviceHealthScriptType para a política de script. Os valores possíveis são: deviceHealthScript e managedInstallerScript.
detectionScriptParameters coleção deviceHealthScriptParameter Lista de objetos ComplexType DetectionScriptParameters.
remediationScriptParameters coleção deviceHealthScriptParameter Lista de objetos ComplexType RemediationScriptParameters.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto deviceHealthScript no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

{
  "@odata.type": "#microsoft.graph.deviceHealthScript",
  "publisher": "Publisher value",
  "version": "Version value",
  "displayName": "Display Name value",
  "description": "Description value",
  "detectionScriptContent": "ZGV0ZWN0aW9uU2NyaXB0Q29udGVudA==",
  "remediationScriptContent": "cmVtZWRpYXRpb25TY3JpcHRDb250ZW50",
  "runAsAccount": "user",
  "enforceSignatureCheck": true,
  "runAs32Bit": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "isGlobalScript": true,
  "highestAvailableVersion": "Highest Available Version value",
  "deviceHealthScriptType": "managedInstallerScript",
  "detectionScriptParameters": [
    {
      "@odata.type": "microsoft.graph.deviceHealthScriptStringParameter",
      "name": "Name value",
      "description": "Description value",
      "isRequired": true,
      "applyDefaultValueWhenNotAssigned": true,
      "defaultValue": "Default Value value"
    }
  ],
  "remediationScriptParameters": [
    {
      "@odata.type": "microsoft.graph.deviceHealthScriptStringParameter",
      "name": "Name value",
      "description": "Description value",
      "isRequired": true,
      "applyDefaultValueWhenNotAssigned": true,
      "defaultValue": "Default Value value"
    }
  ]
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1448

{
  "@odata.type": "#microsoft.graph.deviceHealthScript",
  "id": "bcb60502-0502-bcb6-0205-b6bc0205b6bc",
  "publisher": "Publisher value",
  "version": "Version value",
  "displayName": "Display Name value",
  "description": "Description value",
  "detectionScriptContent": "ZGV0ZWN0aW9uU2NyaXB0Q29udGVudA==",
  "remediationScriptContent": "cmVtZWRpYXRpb25TY3JpcHRDb250ZW50",
  "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"
  ],
  "isGlobalScript": true,
  "highestAvailableVersion": "Highest Available Version value",
  "deviceHealthScriptType": "managedInstallerScript",
  "detectionScriptParameters": [
    {
      "@odata.type": "microsoft.graph.deviceHealthScriptStringParameter",
      "name": "Name value",
      "description": "Description value",
      "isRequired": true,
      "applyDefaultValueWhenNotAssigned": true,
      "defaultValue": "Default Value value"
    }
  ],
  "remediationScriptParameters": [
    {
      "@odata.type": "microsoft.graph.deviceHealthScriptStringParameter",
      "name": "Name value",
      "description": "Description value",
      "isRequired": true,
      "applyDefaultValueWhenNotAssigned": true,
      "defaultValue": "Default Value value"
    }
  ]
}
  • Última atualização em