Compartilhar via

Criar deviceHealthScript

Namespace: microsoft.graph

Importante: A Microsoft suporta Intune /beta APIs, mas estão sujeitas a alterações mais frequentes. Quando possível, a Microsoft recomenda a utilização da versão v1.0. Verifique a disponibilidade de uma API na versão v1.0 com 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 .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government 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) DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.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 do pedido, forneça uma representação JSON para o objeto deviceHealthScript.

A tabela seguinte mostra as propriedades necessárias quando cria o deviceHealthScript.

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador Exclusivo para o script de estado de funcionamento do dispositivo
publicador Cadeia de caracteres Nome do publicador do script de estado de funcionamento do dispositivo
versão Cadeia de caracteres Versão do script de estado de funcionamento do dispositivo
displayName Cadeia de caracteres Nome do script de estado de funcionamento do dispositivo
description Cadeia de caracteres Descrição do script de estado de funcionamento do dispositivo
detectionScriptContent Binária Todo o conteúdo do script do PowerShell de deteção
remediationScriptContent Binária Todo o conteúdo do script do PowerShell de remediação
createdDateTime DateTimeOffset O carimbo de data/hora de quando o script de estado de funcionamento do dispositivo foi criado. Essa propriedade é somente leitura.
lastModifiedDateTime DateTimeOffset O carimbo de data/hora de quando o script de estado de funcionamento 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, user.
enforceSignatureCheck Booliano Indicar se a assinatura de script precisa de ser verificada
runAs32Bit Booliano Indicar se os scripts do PowerShell devem ser executados como 32 bits
roleScopeTagIds String collection Lista de IDs de Etiquetas de Âmbito para o script de estado de funcionamento do dispositivo
isGlobalScript Booliano Determina se se trata de Script Proprietário da Microsoft. Os scripts proprietários são só de leitura
highestAvailableVersion Cadeia de caracteres Versão mais elevada 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, managedInstallerScript.
detectionScriptParameters coleção deviceHealthScriptParameter Lista de objetos ComplexType DetectionScriptParameters.
remediationScriptParameters coleção deviceHealthScriptParameter Lista de objetos ComplexType RemediationScriptParameters.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de 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"
    }
  ]
}
  • Last updated on