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


Обновление cloudPcProvisioningPolicy

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

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

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

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

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

Свойство Тип Описание
cloudPcNamingTemplate String Шаблон, используемый для имен облачных компьютеров, подготовленных с помощью этой политики. Шаблон может содержать настраиваемый текст и маркеры замены, включая %USERNAME:x% и %RAND:x%, которые представляют имя пользователя и случайно созданное число соответственно. Например, означает, CPC-%USERNAME:4%-%RAND:5% что имя облачного компьютера начинается с CPC-, за которым следует имя пользователя из четырех символов, - символ, а затем пять случайных символов. Общая длина текста, созданного шаблоном, не может превышать 15 символов. Поддерживает $filter, $select и $orderby.
description String Описание политики подготовки.
displayName String Отображаемое имя политики подготовки.
domainJoinConfigurations Коллекция cloudPcDomainJoinConfiguration Указывает список, упорядоченный по приоритету для присоединения облачных компьютеров к Microsoft Entra ID.
enableSingleSignOn Логический True Значение , если к подготовленному облачному компьютеру можно получить доступ с помощью единого входа. False указывает, что подготовленный облачный компьютер не поддерживает эту функцию. Значение по умолчанию — false. Windows 365 пользователи могут использовать единый вход для проверки подлинности, чтобы Microsoft Entra ID с помощью параметров без пароля (например, ключей FIDO) для доступа к облачному компьютеру. Необязательный параметр.
imageDisplayName String Отображаемое имя образа ОС, который вы подготавливаете.
imageId String Идентификатор образа ОС, который требуется подготовить на облачных компьютерах. Формат изображения типа коллекции: {publisher_offer_sku}. Ниже перечислены поддерживаемые значения для каждого из параметров.
  • publisher: Microsoftwindowsdesktop.
  • предложение: windows-ent-cpc.
  • sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365и 19h2-ent-cpc-os.
imageType cloudPcProvisioningPolicyImageType Тип образа ОС (пользовательский или коллекцию), который требуется подготовить на облачных компьютерах. Возможные значения: gallery, custom, unknownFutureValue.
microsoftManagedDesktop microsoftManagedDesktop Конкретные параметры microsoftManagedDesktop , которые позволяют клиентам Microsoft Managed Desktop получать управляемые устройствами интерфейс для облачного компьютера. Чтобы включить microsoftManagedDesktop для предоставления дополнительных значений, администратор должен указать в нем определенные параметры. Поддерживает $filter, $select и $orderBy.
windowsSetting cloudPcWindowsSetting Указывает конкретный параметр Windows для настройки во время создания облачных компьютеров для этой политики подготовки. Поддерживает $select.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Примеры

Запрос

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

PATCH https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "displayName": "HR provisioning policy",
  "description": "Provisioning policy for India HR employees"
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content