连接到 Oracle C3 (预览版)

July 9, 2026

投稿者:

创建和管理连接和资源一文介绍了通用连接工作流。以下信息涵盖了 Oracle C3 特有的详细信息。

注意：

在创建到 Oracle C3 的连接之前，请完成 Oracle C3 环境的设置。请参阅 Oracle C3 虚拟化环境。

创建新的连接

您可以使用以下方式创建到 Oracle C3 的连接：

Web 工作室
PowerShell commands

使用 Web Studio 创建连接

在 添加连接和资源 中，选择 Oracle C3 作为连接类型。
Under Oracle Compute Cloud@Customer configuration, select Import configuration, and paste the Oracle C3 configuration file (.ini) content.
在私钥下，选择 添加密钥，然后粘贴凭据文件 (.pem) 中的私钥内容。
输入一个易记的 连接名称。
继续完成向导并验证连接性。

注意：

服务帐户 ID 从导入的配置中提取，无法在 Web Studio 中直接编辑。Oracle C3 端点也从导入配置中的 region 值派生，并且无法在此流程中手动输入。以 Oracle C3 格式输入 region 作为 <service_name>.<domain_name>（FQDN 样式值）。

在 Web Studio 中导入配置时，仅导入以下密钥。所有其他密钥都将被忽略：

user
fingerprint
tenancy
region

在以下证书场景中，连接设置可能会停止：

证书验证或指纹验证失败：在问题解决之前，连接创建将被阻止。

使用 PowerShell 命令创建连接

使用 PowerShell 创建连接时，请提供：

Oracle C3 端点地址，通常为 https://iaas.<service_name>.<domain_name>。
配置文件中的 Oracle C3 用户 OCID (user)。
凭据文件中的私钥内容 (.pem)，作为安全字符串传递。
CustomProperties XML，其中包含 TenancyOcid、Fingerprint 和 Region。
用于证书信任验证的 SSL 指纹（如果需要）。

示例模式：

$CustomProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">' +

'<Property xsi:type="StringProperty" Name="TenancyOcid" Value="' + $TenancyOcid + '" />' +

'<Property xsi:type="StringProperty" Name="Fingerprint" Value="' + $Fingerprint + '" />' +

'<Property xsi:type="StringProperty" Name="Region" Value="' + $Region + '" />' +

'</CustomProperties>'

$PrivateKey = ConvertTo-SecureString $PrivateKeyContent -AsPlainText -Force

New-Item -ConnectionType "Custom" `

-HypervisorAddress $Endpoint `

-Path @("XDHyp:\Connections\$ConnectionName") `

-Persist `

-PluginId "OracleC3PluginFactory" `

-CustomProperties $CustomProperties `

-SecurePassword $PrivateKey `

-UserName $UserOcid `

-SslThumbprint $SslThumbprint

<!--NeedCopy-->

注意：

将 $Region 设置为 <service_name>.<domain_name> 格式的 Oracle C3 区域值。如果您的证书信任策略要求，请使用 -SslThumbprint。

证书和指纹的有效性检查

要成功建立 Oracle C3 连接，证书验证必须成功，并且在需要时指纹值必须正确。

连接的管理

本节内容包括：

使用 Web Studio 修复证书问题
使用 PowerShell 更新指纹值

修复证书问题

当出现证书问题时，Citrix 会阻止 Oracle C3 连接以保护工作负载操作。主机连接列表中连接旁边会显示一个错误图标。

修复方法：

从主机连接中打开连接。
查看故障排除详细信息并识别证书问题。
选择编辑连接 > 编辑设置。
对于 Oracle C3，如果出现提示，请重新导入配置和私钥。当两者都可用时，保存更改以触发新一轮的证书验证（如同连接创建期间），并在出现时验证/信任更新的证书指纹。

更新指纹数值

创建后，您可以使用 Set-Item 更新指纹值。

获取连接详细信息。

Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
<!--NeedCopy-->

更新指纹值。

Set-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> `

-Username <UserName> `

-SslThumbprint <ThumbprintValue>
<!--NeedCopy-->

验证更新后的值：

Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
<!--NeedCopy-->

注意：

如果提供的指纹不正确或与服务器证书信任不匹配，则更新失败。

后续步骤

如果您处于初始部署过程中，请参阅创建计算机目录
有关 Oracle C3 的特定信息，请参阅创建 Oracle C3 计算机目录