Тип ресурса cloudPcOnPremisesConnection

Статья
04/01/2024

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

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

Важно!

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

Методы

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

Свойства

Свойство	Тип	Описание
adDomainName	String	Полное доменное имя домена Active Directory, к которому вы хотите присоединиться. Максимальная длина — 255. Необязательный параметр.
adDomainPassword	String	Пароль, связанный с именем пользователя учетной записи Active Directory (adDomainUsername).
adDomainUsername	String	Имя пользователя учетной записи Active Directory (пользователя или учетной записи службы), которая имеет разрешение на создание объектов-компьютеров в Active Directory. Обязательный формат: `admin@contoso.com`. Необязательный параметр.
alternateResourceUrl	String	URL-адрес интерфейса ресурса партнерской службы, который ссылается на это сетевое подключение Azure. Возвращается только с помощью оператора `$select`.
connectionType	cloudPcOnPremisesConnectionType	Указывает, как подготовленный облачный компьютер присоединяется к Microsoft Entra. Он включает в себя различные типы, один из которых является Microsoft Entra ID присоединении. Это означает, что в текущем клиенте нет локальная служба Active Directory (AD), а устройство облачного компьютера присоединяется Microsoft Entra. Другой — hybridAzureADJoin. Это означает, что в текущем клиенте также есть локальная служба Active Directory (AD), а устройство облачного компьютера присоединяется к локальная служба Active Directory (AD) и Microsoft Entra. Тип также определяет, какие типы пользователей могут быть назначены и могут входить в облачный компьютер. Тип azureADJoin указывает, что можно назначить пользователей только облачных и гибридных пользователей и войти в облачный компьютер. hybridAzureADJoin указывает, что только гибридные пользователи могут быть назначены и вошли в облачный компьютер. Значение по умолчанию — `hybridAzureADJoin`.
displayName	String	Отображаемое имя сетевого подключения Azure.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	Состояние последней проверка работоспособности, выполненной в локальном подключении. Например, если состояние равно `passed`, локальное подключение прошло все проверки, выполняемые службой. Возможные значения: `pending`, `running`, `passed`, `failed`, `warning`. `informational` Значение по умолчанию: `pending`. Только для чтения.
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Указывает результаты проверок работоспособности, выполненных в локальном подключении. Только для чтения. Возвращается только с помощью оператора `$select`. Пример, показывающий, как получить свойство inUse , см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetail. Только для чтения.
id	String	Уникальный идентификатор сетевого подключения Azure. Только для чтения.
InUse	Логический	Если `true`задано значение , используется сетевое подключение Azure. Если `false`задано значение , подключение не используется. Вы не можете удалить используемое подключение. Возвращается только с помощью оператора `$select`. Пример, показывающий, как получить свойство inUse , см. в примере 2. Получение выбранных свойств сетевого подключения Azure, включая healthCheckStatusDetail. Только для чтения.
organizationalUnit	String	Подразделение, в котором создается учетная запись компьютера. Если оставить значение NULL, используется подразделение, настроенное в качестве контейнера объектов по умолчанию (известный контейнер объектов компьютера) в домене Active Directory клиента. Необязательный параметр.
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 используется для создания сетевого подключения Azure. Только для чтения.
virtualNetworkId	String	Уникальный идентификатор целевой виртуальной сети, используемой с локальным сетевым подключением для облачных компьютеров. Обязательный формат: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}"
virtualNetworkLocation	String	Указывает расположение ресурса целевой виртуальной сети. Например, расположение может быть eastus2, westeurope и т. д. Только для чтения (вычисляемое значение).

значения cloudPcOnPremisesConnectionType

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

Значения cloudPcOnPremisesConnectionStatus

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

Связи

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

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

Ниже приведен пример типа ресурса.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": {
    "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail",
    "endDateTime": "String (timestamp)",
    "healthChecks": [
      { 
        "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
        "additionalDetail": "String",
        "displayName": "String",
        "endDateTime": "String (timestamp)",
        "errorType": "String",
        "recommendedAction": "String",
        "correlationId": "String",
        "startDateTime": "String (timestamp)",
        "status": "String"
      }
    ],
    "startDateTime": "String (timestamp)"
  },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "connnecetionType": "String",
  "virtualNetworkId": "String"
}