Тип ресурса cloudPcOnPremisesConnection

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

Важно!

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

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

Важно!

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

Методы

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

Свойства

Свойство Тип Описание
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.
healthCheckPaused Логический Указывает, приостановлены или активны регулярные проверки работоспособности в конфигурации сети или домена. false Если в настоящее время активны регулярные проверки работоспособности в конфигурации сети или домена. true Значение , если проверки приостановлены. При выполнении операции создания или обновления для ресурса onPremisesNetworkConnection это значение устанавливается false в течение четырех недель. Если вы повторите попытку проверка работоспособности в конфигурации сети или домена, это значение будет установлено в false течение двух недель. Если ресурс onPremisesNetworkConnection подключен к provisioningPolicy или используется облачным компьютером в течение последних четырех недель, healthCheckPaused для него задано значение false. Только для чтения. Значение по умолчанию: false.
healthCheckStatus cloudPcOnPremisesConnectionStatus Состояние последней проверка работоспособности, выполненной в сетевом подключении Azure. Например, если состояние равно passed, Azure сетевое подключение прошло все проверки, выполняемые службой. Возможные значения: pending, running, passed, failed, warning, informational, unknownFutureValue. Только для чтения.
healthCheckStatusDetails cloudPcOnPremisesConnectionStatusDetails Сведения о проверках работоспособности подключения и соответствующие результаты. Возвращается только с помощью оператора $select. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.
healthCheckStatusDetail cloudPcOnPremisesConnectionStatusDetail Указывает результаты проверок работоспособности, выполненных в локальном подключении. Возвращается только с помощью оператора $select. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.
id String Уникальный идентификатор сетевого подключения Azure. Только для чтения.
InUse Логический Если trueиспользуется Azure сетевое подключение. Если falseзадано значение , подключение не используется. Вы не можете удалить используемое подключение. Возвращается только с помощью оператора $select. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.
inUseByCloudPc Логический Указывает, использует ли облачный компьютер это локальное сетевое подключение. true если его использует хотя бы один облачный компьютер. В противном случае — falseзначение . Только для чтения. Значение по умолчанию: false.
Managedby cloudPcManagementService Указывает, какие службы управляют сетевым подключением Azure. Допустимые значения: windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. Prefer: include-unknown-enum-members Используйте заголовок запроса, чтобы получить следующие члены в этой развиваемой перечислении: rpaBox, microsoft365Opal, microsoft365BizChat. Только для чтения.
organizationalUnit String Подразделение, в котором создается учетная запись компьютера. Если оставить значение NULL, используется подразделение, настроенное по умолчанию (известный контейнер объектов компьютера) в домене Active Directory. Необязательный параметр.
organizationalUnit String Подразделение, в котором создается учетная запись компьютера. Если оставить значение NULL, используется подразделение, настроенное по умолчанию (известный контейнер объектов компьютера) в домене Active Directory. Необязательный параметр.
resourceGroupId String Идентификатор целевой группы ресурсов. Обязательный формат: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}.
scopeIds Коллекция строк Идентификаторы область соответствующего разрешения. В настоящее время это идентификатор тега Intune область.
subnetId String Идентификатор целевой подсети. Обязательный формат: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}.
subscriptionId String Идентификатор целевой Azure подписки, связанной с клиентом.
subscriptionName String Имя целевой подписки Azure. Только для чтения.
virtualNetworkId String Идентификатор целевой виртуальной сети. Обязательный формат: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}.
virtualNetworkLocation String Указывает расположение ресурса виртуальной целевой сети. Вычисленное значение, доступное только для чтения.
healthCheckStatusDetails (не рекомендуется) cloudPcOnPremisesConnectionStatusDetails Указывает проверки работоспособности подключения и соответствующие результаты. Возвращается только с помощью оператора $select. Пример получения свойства inUse см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения. Свойство healthCheckStatusDetails устарело и не возвращает данные 31 января 2024 г. В дальнейшем используйте свойство healthCheckStatusDetail .
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 .
subnetPrivateIpDetail cloudPcOnPremisesConnectionSubnetIpDetail Содержит подробные сведения о частных IP-адресах, связанных с подсетью. Возвращается только с помощью оператора $select. Пример получения определенных свойств с помощью $selectсм. в разделе Пример 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetails. Только для чтения.

Значения cloudPcManagementService

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

значения 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",
  "healthCheckPaused": "Boolean",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subnetPrivateIpDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail" },
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}
  • Last updated on