命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示定义的Azure资源信息集合，可用于为云电脑建立Azure网络连接。
重要
本地网络连接已重命名为Azure网络连接。 此处的 cloudPcOnPremisesConnection 对象等效于云电脑产品的Azure网络连接。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | cloudPcOnPremisesConnection 集合 | 列出 cloudPcOnPremisesConnection 对象的属性和关系。 |
| Get | cloudPcOnPremisesConnection | 读取 cloudPcOnPremisesConnection 对象的属性和关系。 |
| 创建 | cloudPcOnPremisesConnection | 创建新的 cloudPcOnPremisesConnection 对象。 |
| 更新 | cloudPcOnPremisesConnection | 更新 cloudPcOnPremisesConnection 对象的属性。 |
| 删除 | 无 | 删除 cloudPcOnPremisesConnection 对象。 无法删除正在使用的连接。 |
| 运行运行状况检查 | 无 | 在 cloudPcOnPremisesConnection 上运行运行状况检查。 |
| 更新 Active Directory 域密码 | 无 | 为成功的 cloudPcOnPremisesConnection 更新 Active Directory 域密码。 当 cloudPcOnPremisesConnection 对象的类型为 hybridAzureADJoin时，支持此 API。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| adDomainName | String | 要加入的 Active Directory 域 (FQDN) 的完全限定域名。 可选。 |
| adDomainPassword | String | 与 adDomainUsername 关联的密码。 |
| adDomainUsername | String | Active Directory 帐户的用户名 (有权在 Active Directory 中创建计算机对象的用户或服务帐户) 。 必需格式： admin@contoso.com。 可选。 |
| alternateResourceUrl | String | 链接到此Azure网络连接的合作伙伴服务资源的接口 URL。 仅在 $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 属性已弃用，并且已于 2024 年 1 月 31 日停止返回数据。 今后，请使用 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、microsoft365Opal、microsoft365BizChat。 使用 Prefer: include-unknown-enum-members 请求标头获取此 可演变枚举中的以下成员： rpaBox。 只读。 |
| organizationalUnit | String | 组织单位 (在其中创建计算机帐户的 OU) 。 如果保留 null，则使用 active Directory 域中已知计算机对象容器) (配置为默认的 OU (OU) 。 可选。 |
| organizationalUnit | String | 组织单位 (在其中创建计算机帐户的 OU) 。 如果保留 null，则使用 active Directory 域中已知计算机对象容器) (配置为默认的 OU (OU) 。 可选。 |
| virtualNetworkId | String | 目标虚拟网络的 ID。 必需格式： /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}。 |
| virtualNetworkLocation | String | 指示虚拟目标网络的资源位置。 只读的计算值。 |
| resourceGroupId | String | 目标资源组的 ID。 必需格式： /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}。 |
| subnetId | String | 目标子网的 ID。 必需格式： /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}。 |
| subscriptionId | String | 与租户关联的目标Azure订阅的 ID。 |
| subscriptionName | String | 目标Azure订阅的名称。 只读。 |
| 类型 (已弃用) | cloudPcOnPremisesConnectionType | 指定将预配的云电脑联接到Microsoft Entra的方法。 选项azureADJoin指示当前租户中没有本地 Active Directory (AD) ，这会导致云电脑设备仅加入到Microsoft Entra。
hybridAzureADJoin选项指示当前租户中是否存在本地 AD，并且云电脑同时加入本地 AD 和 Microsoft Entra。 所选选项还确定可以分配并可以登录到云电脑的用户的类型。 选项 azureADJoin 允许分配仅云用户和混合用户并登录，而 hybridAzureADJoin 仅限于混合用户。 默认值为 hybridAzureADJoin。 可能的值包括 hybridAzureADJoin、azureADJoin、unknownFutureValue。
type 属性在 2024 年 1 月 31 日已弃用并停止返回数据。 今后，请使用 connectionType 属性。 |
cloudPcManagementService 值
| 成员 | 说明 |
|---|---|
| windows365 | Azure通过 Windows 365 成功创建网络连接。 |
| devBox | Azure通过 Project Fidalgo 成功创建网络连接。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| rpaBox | Azure网络连接已通过 Power Automate 项目成功创建。 |
| microsoft365Opal | 指示云电脑Azure网络连接已成功通过 Project Opal 创建。 |
| microsoft365BizChat | 指示通过 Project Biz Chat 成功创建了云电脑Azure网络连接。 |
cloudPcOnPremisesConnectionType 值
| 成员 | 说明 |
|---|---|
| azureADJoin | 仅联接到Microsoft Entra ID。 可以分配仅限云的用户和混合用户并登录到云电脑。 |
| hybridAzureADJoin | 已加入到本地 Active Directory和Microsoft Entra ID。 只能分配混合用户并登录到云电脑。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
cloudPcOnPremisesConnectionStatus 值
| 成员 | 说明 |
|---|---|
| 失败 | 运行状况检查通知客户Azure网络连接未正确配置或未正常运行。 预配失败。 客户需要识别问题，并使用Azure网络连接提供的指南来解决该问题，以便成功预配。 |
| 信息 | 运行状况检查向客户提供有关云电脑加载项功能（例如单一登录）的当前或关联的先决条件检查的信息。 信息运行状况检查不会影响客户的云电脑的预配。 此信息旨在优化用户体验。 |
| 通过 | 运行状况检查通知客户Azure网络连接按预期运行。 客户可以毫无问题地预配其云电脑。 |
| 待定 | 已创建并等待运行状况检查。 |
| 运行 | 运行状况检查正在运行。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| 警告 | 运行状况检查通知客户，Azure网络连接未按照Microsoft最佳做法指南（例如终结点连接）进行配置。 在预配云电脑之前，客户应配置云电脑所需的终结点。 它不会影响客户的云电脑预配，但可能会影响客户体验。 |
关系
无。
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"
}