Тип ресурса cloudPcOnPremisesConnection

Статья
03/18/2024

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет определенную коллекцию сведений о ресурсах Azure, которые можно использовать для подключения к сети Azure для облачных компьютеров.

Важно!

Локальное сетевое подключение было переименовано в сетевое подключение Azure. Объекты cloudPcOnPremisesConnection здесь эквивалентны сетевому подключению Azure для облачного компьютера.

Методы

Метод	Тип возвращаемых данных	Описание
Список onPremisesConnections	Коллекция cloudPcOnPremisesConnection	Перечисление свойств и связей объектов cloudPcOnPremisesConnection .
Получение cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Чтение свойств и связей объекта cloudPcOnPremisesConnection .
Создание cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Создайте объект cloudPcOnPremisesConnection .
Обновление cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Обновление свойств объекта cloudPcOnPremisesConnection .
Удаление cloudPcOnPremisesConnection	Нет	Удалите объект cloudPcOnPremisesConnection . Вы не можете удалить используемое подключение.
RunHealthChecks для cloudPcOnPremisesConnection	Нет	Выполните проверки работоспособности в cloudPcOnPremisesConnection.
updateAdDomainPassword	Нет	Обновите пароль домена Active Directory для успешного cloudPcOnPremisesConnection. Этот API поддерживается, если тип объекта cloudPcOnPremisesConnection имеет значение `hybridAzureADJoin`.

Свойства

Свойство	Тип	Описание
adDomainName	String	Полное доменное имя домена Active Directory, к которому вы хотите присоединиться. Необязательный параметр.
adDomainPassword	String	Пароль, связанный с adDomainUsername.
adDomainUsername	String	Имя пользователя учетной записи Active Directory (пользователя или учетной записи службы), которая имеет разрешения на создание объектов-компьютеров в Active Directory. Обязательный формат: `admin@contoso.com`. Необязательный параметр.
alternateResourceUrl	String	URL-адрес интерфейса ресурса партнерской службы, который ссылается на это сетевое подключение Azure. Возвращается только с помощью оператора `$select`.
connectionType	cloudPcOnPremisesConnectionType	Указывает метод, с помощью которого подготовленный облачный компьютер присоединяется к Microsoft Entra. Параметр `azureADJoin` указывает на отсутствие локальная служба Active Directory (AD) в текущем клиенте, что приводит к присоединению устройства облачного компьютера только к Microsoft Entra. Параметр `hybridAzureADJoin` указывает на наличие локальной службы AD в текущем клиенте и на то, что облачный компьютер присоединяется как к локальному AD, так и к Microsoft Entra. Выбранный параметр также определяет типы пользователей, которые могут быть назначены и могут входить в облачный компьютер. Этот `azureADJoin` параметр позволяет назначать и выполнять вход только облачным и гибридным пользователям, тогда как он ограничен только гибридными `hybridAzureADJoin` пользователями. Значение по умолчанию — `hybridAzureADJoin`. Допустимые значения: `hybridAzureADJoin`, `azureADJoin`, `unknownFutureValue`.
displayName	String	Отображаемое имя сетевого подключения Azure.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	Состояние последней проверка работоспособности, выполненной в сетевом подключении Azure. Например, если состояние равно `passed`, сетевое подключение Azure прошло все проверки, выполняемые службой. Возможные значения: `pending`, `running`, `passed`, `failed`, `warning`, `informational`, `unknownFutureValue`. Только для чтения.
healthCheckStatusDetails	cloudPcOnPremisesConnectionStatusDetails	Сведения о проверках работоспособности подключения и соответствующие результаты. Возвращается только с помощью оператора `$select`. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.
healthCheckStatusDetails (не рекомендуется)	cloudPcOnPremisesConnectionStatusDetails	Указывает проверки работоспособности подключения и соответствующие результаты. Возвращается только с помощью оператора `$select`. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения. Свойство healthCheckStatusDetails устарело и не возвращает данные 31 января 2024 г. Перейдите вперед, используйте свойство healthCheckStatusDetail .
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Указывает результаты проверок работоспособности, выполненных в локальном подключении. Возвращается только с помощью оператора `$select`. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.
id	String	Уникальный идентификатор сетевого подключения Azure. Только для чтения.
InUse	Логический	Если `true`задано значение , используется сетевое подключение Azure. Если `false`задано значение , подключение не используется. Вы не можете удалить используемое подключение. Возвращается только с помощью оператора `$select`. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.
Managedby	cloudPcManagementService	Указывает, какие службы управляют сетевым подключением Azure. Возможные значения: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`. Необходимо использовать `Prefer: include-unknown-enum-members` заголовок запроса, чтобы получить следующие значения в этом развиваемом перечислении: `rpaBox`. Только для чтения.
organizationalUnit	String	Подразделение, в котором создается учетная запись компьютера. Если оставить значение NULL, используется подразделение, настроенное как контейнер объектов по умолчанию (известный контейнер объектов компьютера) в домене Active Directory. Необязательный параметр.
organizationalUnit	String	Подразделение, в котором создается учетная запись компьютера. Если оставить значение NULL, используется подразделение, настроенное по умолчанию (известный контейнер объектов компьютера) в домене Active Directory. Необязательный параметр.
virtualNetworkId	String	Идентификатор целевой виртуальной сети. Обязательный формат: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}`.
virtualNetworkLocation	String	Указывает расположение ресурса виртуальной целевой сети. Вычисленное значение, доступное только для чтения.
resourceGroupId	String	Идентификатор целевой группы ресурсов. Обязательный формат: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}`.
subnetId	String	Идентификатор целевой подсети. Обязательный формат: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}`.
subscriptionId	String	Идентификатор целевой подписки Azure, связанной с вашим клиентом.
subscriptionName	String	Имя целевой подписки Azure. Только для чтения.
type (не рекомендуется)	cloudPcOnPremisesConnectionType	Указывает метод, с помощью которого подготовленный облачный компьютер присоединяется к Microsoft Entra. Параметр `azureADJoin` указывает на отсутствие локальная служба Active Directory (AD) в текущем клиенте, что приводит к присоединению устройства облачного компьютера только к Microsoft Entra. Параметр `hybridAzureADJoin` указывает на наличие локальной службы AD в текущем клиенте и на то, что облачный компьютер присоединяется как к локальному AD, так и к Microsoft Entra. Выбранный параметр также определяет типы пользователей, которые могут быть назначены и могут входить в облачный компьютер. Этот `azureADJoin` параметр позволяет назначать и выполнять вход только облачным и гибридным пользователям, тогда как он ограничен только гибридными `hybridAzureADJoin` пользователями. Значение по умолчанию — `hybridAzureADJoin`. Допустимые значения: `hybridAzureADJoin`, `azureADJoin`, `unknownFutureValue`. Свойство type устарело и не возвращает данные 31 января 2024 г. Перейдите вперед, используйте свойство connectionType .

Значения cloudPcManagementService

Member	Описание
devBox	Сетевое подключение Azure успешно создано через Project Fidalgo.
rpaBox	Сетевое подключение Azure было успешно создано с помощью проекта Power Automate.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
windows365	Сетевое подключение Azure было успешно создано через Windows 365.

значения cloudPcOnPremisesConnectionType

Member	Описание
azureADJoin	Присоединено только к Microsoft Entra ID. Только облачных и гибридных пользователей можно назначить и войти в облачный компьютер.
hybridAzureADJoin	Присоединено к локальная служба Active Directory и Microsoft Entra ID. Назначить и войти в облачный компьютер можно только гибридным пользователям.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.

Значения cloudPcOnPremisesConnectionStatus

Member	Описание
Сбой при	Проверки работоспособности уведомляют клиента о том, что сетевое подключение Azure неправильно настроено или не работает. Сбой подготовки. Чтобы обеспечить успешную подготовку, клиент должен определить проблему и устранить ее с помощью рекомендаций, предоставляемых сетевым подключением Azure.
Информационных	Проверки работоспособности предоставляют клиенту сведения о текущих или связанных проверках предварительных требований для функций надстройки Cloud PC, таких как единый вход. Это не повлияет на подготовку облачного компьютера клиента, но информация предназначена для оптимизации взаимодействия с пользователем.
Прошло	Проверки работоспособности уведомляют клиента о том, что сетевое подключение Azure работает должным образом. Клиент может подготовить свой облачный компьютер без каких-либо проблем.
Ожидающие	Создано и ожидает проверок работоспособности.
Запущена	Проверки работоспособности выполняются.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
warning	Проверки работоспособности уведомляют клиента о том, что сетевое подключение Azure не настроено в соответствии с рекомендациями Майкрософт, например подключение к конечной точке. Перед подготовкой облачного компьютера клиент должен настроить необходимые конечные точки облачного компьютера. Это не влияет на подготовку облачного компьютера клиента, но может повлиять на работу клиента.

Связи

Отсутствуют.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "connectionType": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}