Тип ресурса cloudPcOnPremisesConnection
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет определенную коллекцию сведений о ресурсах Azure, которые можно использовать для подключения к сети Azure для облачных компьютеров.
Важно!
Локальное сетевое подключение было переименовано в сетевое подключение Azure. Объекты cloudPcOnPremisesConnection здесь эквивалентны сетевому подключению Azure для облачного компьютера.
Методы
| Метод | Тип возвращаемых данных | Описание |
|---|---|---|
| Список | Коллекция cloudPcOnPremisesConnection | Перечисление свойств и связей объектов cloudPcOnPremisesConnection . |
| Получение | cloudPcOnPremisesConnection | Чтение свойств и связей объекта cloudPcOnPremisesConnection . |
| Создание | cloudPcOnPremisesConnection | Создайте объект cloudPcOnPremisesConnection . |
| Обновление | cloudPcOnPremisesConnection | Обновление свойств объекта cloudPcOnPremisesConnection . |
| удаление; | Нет | Удалите объект cloudPcOnPremisesConnection . Вы не можете удалить используемое подключение. |
| Выполнение проверок работоспособности | Нет | Выполните проверки работоспособности в cloudPcOnPremisesConnection. |
| Обновление пароля домена Active Directory | Нет | Обновите пароль домена 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. Только для чтения. |
| inUseByCloudPc | Логический | Указывает, использует ли облачный компьютер это локальное сетевое подключение.
true если его использует хотя бы один облачный компьютер. В противном случае — falseзначение . Только для чтения. Значение по умолчанию: false. |
| healthCheckPaused | Логический |
false Значение , если регулярные проверки работоспособности в конфигурации сети или домена в настоящее время активны.
true Значение , если проверки приостановлены. Если вы выполняете операцию создания или обновления для ресурса onPremisesNetworkConnection , это значение задается в false течение 4 недель. Если вы повторяете проверка работоспособности в конфигурации сети или домена, это значение будет установлено в false течение двух недель. Если ресурс onPremisesNetworkConnection подключен в provisioningPolicy или используется облачным компьютером в течение последних 4 недель, healthCheckPaused для него задано значение false. Только для чтения. Значение по умолчанию: false. |
| 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",
"inUseByCloudPc": "Boolean",
"healthCheckPaused": "Boolean",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String",
"virtualNetworkLocation": "String"
}