Поделиться через

Обновление deviceManagementDerivedCredentialSettings

  • Статья

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

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

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

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

    ## Permissions

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

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

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

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

HTTP-запрос

PATCH /deviceManagement/derivedCredentials/{deviceManagementDerivedCredentialSettingsId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosVpnConfiguration/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosEnterpriseWiFiConfiguration/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosEasEmailProfileConfiguration/derivedCredentialSettings
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosDerivedCredentialAuthenticationConfiguration/derivedCredentialSettings

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

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

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

В тексте запроса укажите представление json для объекта deviceManagementDerivedCredentialSettings .

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

Свойство Тип Описание
id String Уникальный идентификатор для производных учетных данных
Политика ra
helpUrl String URL-адрес, который будет доступен конечным пользователям при получении производных учетных данных с помощью Корпоративный портал.
displayName String Отображаемое имя профиля.
эмитент deviceManagementDerivedCredentialIssuer Используемый поставщик производных учетных данных. Возможные значения: intercede, entrustDatacard, purebred.
notificationType deviceManagementDerivedCredentialNotificationType Методы, используемые для информирования конечного пользователя о том, чтобы открыть Корпоративный портал для доставки Wi-Fi, VPN или профилей электронной почты, использующих сертификаты на устройство. Возможные значения: none, companyPortal, email.

Отклик

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

Пример

Запрос

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

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/derivedCredentialSettings
Content-type: application/json
Content-length: 83

{
  "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings"
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.deviceManagementDerivedCredentialSettings",
  "id": "bc650741-0741-bc65-4107-65bc410765bc"
}