连接到 Oracle C3（预览）
创建和管理连接和资源 一文介绍了通用连接工作流程。以下信息涵盖了 Oracle C3 特有的详细信息。
注意：
在创建到 Oracle C3 的连接之前，请完成 Oracle C3 环境的设置。请参阅 Oracle C3 虚拟化环境。
创建连接
您可以使用以下方式创建到 Oracle C3 的连接：
-
Web 工作室
-
PowerShell 命令
使用 Web Studio 创建连接
-
在添加连接和资源中，选择 Oracle C3 作为连接类型。
-
在 Oracle Compute Cloud@Customer 配置下，选择导入配置，然后粘贴 Oracle C3 配置文件 (
.ini) 的内容。 -
在私钥下，选择添加密钥，然后粘贴凭据文件 (
.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) 中的私钥内容，以安全字符串形式传递。 -
包含
TenancyOcid、Fingerprint和Region的CustomPropertiesXML。 -
用于证书信任验证的 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
注意：
将
$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> -
更新指纹值。
Set-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> `
-Username <UserName> `
-SslThumbprint <ThumbprintValue> -
验证更新后的值：
Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
注意：
如果提供的指纹不正确或与服务器证书信任不匹配，则更新失败。
下一步操作
-
如果您处于初始部署过程中，请参阅创建计算机目录
-
有关 Oracle C3 的具体信息，请参阅创建 Oracle C3 计算机目录