Обновление deviceManagementScript

Пространство имен: microsoft.graph

Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Обновите свойства объекта deviceManagementScript .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тексте запроса укажите представление объекта deviceManagementScript в формате JSON.

В следующей таблице показаны свойства, необходимые при создании deviceManagementScript.

Свойство	Тип	Описание
enforceSignatureCheck	Логический	Укажите, требуется ли проверять подпись скрипта.
runAs32Bit	Логический	Значение , указывающее, должен ли скрипт PowerShell выполняться от 32-разрядной версии.
id	String	Уникальный идентификатор скрипта управления устройствами.
displayName	String	Имя скрипта управления устройствами.
description	String	Необязательное описание скрипта управления устройствами.
scriptContent	В двоичном формате	Содержимое скрипта.
createdDateTime	DateTimeOffset	Дата и время создания скрипта управления устройствами. Это свойство доступно только для чтения.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего изменения скрипта управления устройствами. Это свойство доступно только для чтения.
runAsAccount	runAsAccountType	Указывает тип контекста выполнения. Возможные значения: system, user.
fileName	String	Имя файла скрипта.
roleScopeTagIds	Коллекция строк	Список идентификаторов тегов области для этого экземпляра PowerShellScript.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект deviceManagementScript в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}
Content-type: application/json
Content-length: 367

{
  "@odata.type": "#microsoft.graph.deviceManagementScript",
  "enforceSignatureCheck": true,
  "runAs32Bit": true,
  "displayName": "Display Name value",
  "description": "Description value",
  "scriptContent": "c2NyaXB0Q29udGVudA==",
  "runAsAccount": "user",
  "fileName": "File Name value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 539

{
  "@odata.type": "#microsoft.graph.deviceManagementScript",
  "enforceSignatureCheck": true,
  "runAs32Bit": true,
  "id": "59ea4525-4525-59ea-2545-ea592545ea59",
  "displayName": "Display Name value",
  "description": "Description value",
  "scriptContent": "c2NyaXB0Q29udGVudA==",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "runAsAccount": "user",
  "fileName": "File Name value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}