上一主题: 了解 CA ARCserve RHA PowerShell 命令

下一主题: Resume-Scenario - 在挂起的副本主机上恢复复制过程

使用 CA ARCserve RHA PowerShell 命令

本章详细说明了如何使用 CA ARCserve RHA PowerShell 命令来控制、编辑和监视灾难恢复与高可用性过程。 这些命令按字母顺序显示并分为 4 组:连接和注册、控制、编辑和监视。

此部分包含以下主题:

连接和注册命令

控制命令

编辑命令

监视命令

用户管理命令

连接和注册命令

此部分说明了如何连接 Control Service,如何与它断开连接,以及如何为 CA ARCserve RHA 注册输入许可密钥。

Connect-XO - 将 PowerShell 连接到 Control Service

要使用 PowerShell 处理 CA ARCserve RHA 复制方案,首先需要连接用作 CA ARCserve RHA 操作控制点的 Control Service。 Connect-XO 命令可以将 PowerShell 连接到特定 Control Service。

注意:使用完 CA ARCserve RHA PowerShell 后,请不要忘记使用 Disconnect-XO 命令与 Control Service 断开连接。 关闭 PowerShell 窗口也会使 PowerShell 与 Control Service 断开连接。

语法
Connect-XO [-主机] <字符串> [-凭据] <PS 凭据> [[-协议] [<字符串>]] [[-端口] [<字符串>]]
参数
主机

运行 Control Service 的计算机的 IP 地址或主机名。

凭据\PS 凭据

用于 Control Service 的域\用户名。 这些凭据必须属于对 Control Service 具有管理员权限的用户。 输入凭据后,将显示“Windows PowerShell 凭据请求”对话框,提示您输入密码。

注意:要避免手工将凭据输入“PS 凭据”对话框中,请参阅“使用脚本将 PowerShell 连接到 Control Service”。

协议

用于连接到 Control Service 的协议。 输入以下项之一:http https

端口(可选)

用于连接到 Control Service 的 TCP/IP 端口。 对于 http,默认值为 8088;对于 https,默认值为 443

示例:连接到 Control Service

connect-xo 192.168.1.151 qa88-w3k3\administrator https

结果

显示“Windows PowerShell 凭据请求”对话框,提示您输入密码。 然后,将显示以下内容:

正在连接...
192.168.1.151 已连接!

使用脚本将 PowerShell 连接到 Control Service

您可以加密密码并将其作为对象运行,这样即可避免手工将凭据输入“PS 凭据”对话框中。

加密密码并将其作为对象运行

输入以下命令,在要求时输入密码,然后运行一次该命令:

read-host -assecurestring | convertfrom-securestring | out-file C:\ securestring.txt <password>
$pass = cat C:\securestring.txt | convertto-securestring
$mycred = new-object -typename System.Management.Automation.PSCredential -argumentlist <domain\user_name>, $pass
Connect -XO [-Host] <String> $mycred [[-Protocol][<String>]] [[-Port] [<String>]]

结果与标准连接中相同:

正在连接...
<IP 地址> 已连接! 

有关详细信息,请参阅 PowerShell 文档或搜索 Internet。

Disconnect-XO - 与正在运行的 Control Service 断开连接

使用完 CA ARCserve RHA PowerShell 之后,需要与正在运行的 Control Service 断开连接。 Disconnect-XO 命令可以使 PowerShell 与正在运行的 Control Service 断开连接。

注意:关闭 PowerShell 窗口也会使 PowerShell 与 Control Service 断开连接。

语法
Disconnect-XO

注意:该命令没有参数。 该命令会自动断开正在运行的 Control Service。

示例:断开 Control Service

disconnect-xo

结果:

192.168.1.151 已断开!

Get-License - 显示您的 CA ARCserve RHA 许可

Get-License 命令可以显示您的 CA ARCserve RHA 许可详细信息。

语法
get-license

示例:显示您的 CA ARCserve RHA 许可详细信息

get-license

结果:

注册表项:TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456
公司:
许可失效时间: 11  2009
维护延至: 11  2009
Assured Recovery 节点数目: 240
CDP 存储库节点数目: 240

产品列表:
- Application Server, Windows Cluster edition, 30 个高可用性实例
- File server, Windows Enterprise edition, 130 个高可用性实例
- Application Server, Windows Enterprise edition, 130 个灾难恢复实例
- File server, Windows Enterprise edition, 30 个灾难恢复实例
- Application Server, Virtual Machine, 100 个灾难恢复实例
- Application Server, Virtual Machine, 100 高可用性实例

Set-License - 注册 CA ARCserve RHA

Set-License 命令可以使用许可密钥来注册 CA ARCserve RHA。 您必须拥有有效的注册密钥才能使用该命令。

语法
set-license
参数

有效的许可密钥。

示例:使用许可密匙注册 CA ARCserve RHA

set-license TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456

结果:

密钥已成功注册
















xo-import-credential

该命令读取给定 xml 文件的所有凭据记录,并通过命令 Add-Credential 将其添加到连接的 Control Service 中。

语法

xo-import-credential

参数

指定 XML 文件名。

输入

无。 没有对象输入到 xo-import-credential。

xo-convertto-securefile

该命令会将一个纯文本 CVS 文件转换为受保护的 xml 文件。

语法

xo-convertto-securefile

参数

指定源文件名和目标。

源应为一个 CSV 文件,其格式如下:

hostname,

username,

密码

host1,

user1,

pwd1

host2,

user2,

pwd2

输入

无。 无对象输入。

xo-credential - 将字符串转换为 PSCredential 对象

使用 xo-credential 命令,可以将用户名和密码字符串转换为受保护的凭据对象,以便在将 PSCredential 对象用作命令参数的其他命令中使用。

语法

xo-credential <username> <password>

示例

xo-credential johnsmith mypword2

控制命令

该部分说明了可以控制灾难恢复和高可用性过程的 CA ARCserve RHA PowerShell 命令。

Diff-Scenario - 生成差异报告

Diff-Scenario 命令可以为指定方案生成一份差异报告。

重要说明! 建议您在主主机上更新数据时不要启用差异报告,因为未应用于副本主机的所有更新均会显示为差异。

语法
Diff-Scenario [-名称] <字符串> [-模式] <字符串> [-忽略] <布尔值> 
参数
名称

要生成报告的方案的名称。 您可以使用 Get-Scenario 命令输入多个方案名称。

模式

同步模式。 输入以下项之一:

B=二进制

F=文件

忽略

比较数据期间忽略名称和大小相同的文件。 输入以下项之一:

1=是

0=否

注意:要在生成差异报告后进行查看,请从概览页打开报告中心,并选择所需报告。

示例:生成差异报告

diff-scenario "File Server 1" F 1

结果:

File Server 1 方案的差异报告正在运行...
完成!

Export-Scenario - 将方案导出到指定位置

Export-Scenario 命令可以将方案导出到其他位置,以备再次使用。 方案将导出为 XMC 文件,您可以指定导出位置。

语法
Export-Scenario [-名称] <字符串> [[-文件] [<字符串>]] 
参数
名称

方案名称。

文件(可选)

导出文件的完整路径。 如果不指定路径,文件将导出到当前目录,且文件名称为方案名称后跟 .xmc 扩展名。

示例:将方案导出到指定位置

export-scenario "File Server 1" C:\Scenarios

结果:

File Server 1 方案成功导出到 C:\Scenarios

Expose-Snapshot - 公开快照

Expose-Snapshot 命令可以公开快照。 您可以将快照安装到未使用的文件夹,从而将其作为本地只读文件夹公开,或者将快照安装到未使用的驱动器,从而将其作为本地只读卷公开。

注意

语法
Expose-Snapshot [-名称] <字符串> [-索引] <Int32> [-路径] <字符串> [-端口] <字符串>
参数
名称

要公开其中快照的主机的名称。

索引

快照的索引编号,即 Get-Snapshot 命令返回的索引号。

路径

要公开的快照所在的路径。 该路径可以是驱动器盘符或一个完整的文件夹路径。

端口(可选)

用于连接指定主机的端口。 默认端口为 25000

示例:将快照作为本地只读卷公开

Expose-Snapshot 192.168.1.153 0 E: 25000

结果:

快照 {97127d0b-f1c9-4db5-943d-96c39b712fe6} 安装为 E:

Import-Scenario - 将方案导入管理器

Import-Scenario 命令可以从指定位置导入 XMC 文件格式的方案。 如果要将方案从一个 Control Service 移至另一个 Control Service,或希望使用系统中保留的较早方案,则可以使用此选项。

语法
Import-Scenario [-文件] <字符串> 
参数
文件

导入的方案文件的完整路径。

注意

示例:将方案从指定位置导入管理器

import-scenario c:\scenarios

结果:

File Server 2 方案从 c:\scenarios 成功导入

Mount-Snapshot - 安装快照

Mount-Snapshot 命令可以安装公开的快照。 您可以将快照作为本地只读文件夹安装到未使用的文件夹,或者将快照作为本地只读卷安装到未使用的驱动器。

语法
Mount-Snapshot [-名称] <字符串> [[-索引] [<Int32>]] [[-路径] [<字符串>]] [[-端口] [<字符串>]]
参数
名称

要安装其中快照的主机的名称。

索引

快照的索引编号,即 Get-Snapshot 命令返回的索引号。

路径

要公开的快照所在的路径。 该路径可以是驱动器盘符或一个完整的文件夹路径。

端口(可选)

用于连接指定主机的端口。 默认端口为 25000

示例:将快照作为本地只读卷安装

mount-snapshot 192.168.1.153 0 F:

结果:

快照 {745d6ce9-d880-40bf-a0cb-d4f0114bb0f8} 安装为 F:

Prepare-Reboot - 准备主机以进行维护

使用 Prepare-Reboot 命令可执行维护过程,如重启主机或在 Microsoft 群集节点之间移动组,完成这些过程后无需再重新执行同步。

主机所参与的方案必须正在运行,才可准备该主机进行维护。 一次只能对一台主机进行准备,但该主机可以参与多个方案。 在这些方案中,该主机既可以作为主主机,也可以作为副本主机。 如果主机参与的方案未运行,则与此方案相关的准备不会进行。

接收到通知您主机正在准备重启的消息后,即可重启主机或在群集节点之间切换组。 完成维护过程后,将自动恢复复制过程,而不必执行重新同步。

注意:如果准备好对主机进行维护后,决定不重新启动主机而是继续运行其方案,则需要停止方案,然后重新运行这些方案。

语法
Prepare-Reboot [-名称] <字符串>
参数
名称

主机名。

示例:准备副本主机以进行重启

Prepare-Reboot QA95-W2K3-EX2

结果:

主机 QA95-W2K3-EX2 正在准备重启

Recover-Scenario - 将丢失的数据从副本主机恢复到主主机

Recover-Scenario 命令可以将主主机丢失的数据从任意参与方案的副本主机传输到主主机,从而恢复数据。 这是通过激活反向同步过程(从副本主机到主主机)来完成的。 激活 Recover-Scenario 命令时,您需要定义要恢复数据的副本主机,以及是否在恢复过程中删除主主机上存在而副本主机上不存在的数据。

重要说明! 您必须停止复制才能启动恢复。

要验证恢复过程是否完成,请使用 Get-Events 命令。 在收到通知您“恢复过程已完成”的消息之后,您可以使用 Run-Scenario 命令来重新启动从主主机到副本主机的复制过程。

语法
Recover-Scenario [-名称] <字符串> [-主机] <字符串> [-模式] <字符串> [-忽略] <布尔值> [-删除主主机文件] <布尔值> [-恢复模式] <字符串> [-恢复后重启] <布尔值> 
参数
名称

方案名称。

主机

要从中恢复数据的副本主机。

模式

同步模式。 输入以下项之一:

B=二进制

F=文件

忽略

比较数据期间忽略名称和大小相同的文件。 输入以下项之一:

1=是

0=否

删除主主机文件

是否要在恢复过程中删除仅存在于主主机上的文件。 输入以下项之一:

1=是,删除仅存在于主主机上的文件

0=否,保留仅存在于主主机上的文件

恢复模式

要恢复的数据类型。 输入以下项之一:

A = 应用程序数据

S = 系统状态数据(仅在“系统状态保护”选项处于活动状态时)

B = 两种数据类型

默认值为 A

恢复后重启

恢复过程完成后是否重启主主机。 输入以下项之一:

1 = 是,重启主主机

2 = 否,不重启主主机

示例:恢复丢失的数据

Recover-Scenario "File Server 1" 192.168.1.153 F 1 0

结果:

恢复应用程序数据过程已启动

Resume-IsAliveCheck - 恢复一个正在运行的方案的 IsAlive 检查。

Resume-IsAliveCheck”命令使您能够手动恢复某个特定 HA 方案的 IsAlive 检查。

语法
Resume-IsAliveCheck [-ScenarioName] <String>
参数
方案名

目标方案名称。

示例:恢复 SQLscenario 的 IsAlive 检查

Resume-IsAliveCheck SQLscenario

结果:

恢复 SQLscenario 的定期 is-alive 检查。