上一個主題: 瞭解 CA ARCserve RHA PowerShell 指令

下一個主題: Resume-Scenario - 繼續已暫停複本上的複製

使用 CA ARCserve RHA PowerShell 指令

本章詳細說明如何使用 CA ARCserve RHA PowerShell 指令來控制、編輯和監視複製以及 HA 程序。 這些指令是依字母順序顯示,而且分成 4 個群組:[連線和登錄]、[控制]、[編輯] 和 [監視]。

本節包含以下主題:

連線及登錄指令

控制指令

編輯指令

監視指令

使用者管理指令

連線及登錄指令

本節說明如何連線至控制服務、如何中斷與它的連線,以及如何輸入授權碼以進行 CA ARCserve RHA 登錄。

Connect-XO將 PowerShell 連線至控制服務

若要使用 PowerShell 來搭配使用 CA ARCserve RHA 案例,首要之務就是連線至做為 CA ARCserve RHA 作業之控制點的控制服務。 Connect-XO 指令可以讓您將 PowerShell 連線至特定的控制服務。

附註:使用完 CA ARCserve RHA PowerShell 後,請記得使用 Disconnect-XO 指令來中斷與控制服務的連線。 關閉 PowerShell 視窗也會一併中斷 PowerShell 與控制服務的連線。

語法
Connect-XO [-Host] <String> [-Credentials] <PSCredential> [[-Protocol] [<String>]] [[-Port] [<String>]]
參數
主機

執行控制服務之機器的 IP 位址或主機名稱。

Credentials\PSCredentials

控制服務的網域\使用者名稱。 這些憑證必須屬於在控制服務上擁有管理權限的使用者。 輸入憑證後,[Windows PowerShell 憑證要求] 對話方塊隨即出現,提示您輸入密碼。

附註:可避免手動輸入憑證至 PSCredentials 對話方塊的需要,請參閱<使用指令碼將 PowerShell 連線至控制服務>。

通訊協定

用於連線至控制服務的通訊協定。 輸入下列其中一個選項:httphttps

Port (選用)

用於連線至控制服務的 TCP/IP 連接埠。 針對 http,預設值為 8088;針對 https,預設值為 443

範例:連線到控制服務

connect-xo 192.168.1.151 qa88-w3k3\administrator https

結果

[Windows PowerShell 憑證要求] 對話方塊隨即出現,提示您輸入密碼。 接著會出現下列:

連線中...
192.168.1.151 已連接!

使用指令碼將 PowerShell 連線至控制服務

將密碼加密,並以物件的形式執行,可避免手動輸入憑證至 PSCredentials 對話方塊的需要。

若要將密碼加密,並以物件的形式執行

輸入下列指令,依據指示使用密碼並執行:

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 Address> 已連線! 

如需詳細資訊,請參閱 PowerShell 說明文件或搜尋網際網路。

Disconnect-XO - 從執行中的控制服務中斷連線

使用 CA ARCserve RHA PowerShell 後,必須從執行中的控制服務中斷連線。 Disconnect-XO 指令可以讓您從執行中的控制服務中斷 PowerShell 的連線。

附註:關閉 PowerShell 視窗也會一併中斷 PowerShell 與控制服務的連線。

語法
Disconnect-XO

附註:這個指令沒有參數。 它會自動與執行中的控制服務中斷連線。

範例:與控制服務中斷連線

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

產品清單:
- 應用程式伺服器:Windows Cluster Edition,30 個執行個體 HA
- 檔案伺服器:Windows Enterprise Edition,130 個執行個體 HA
- 應用程式伺服器:Windows Enterprise Edition,130 個執行個體 DR
- 檔案伺服器:Windows Enterprise Edition,30 個執行個體 DR
- 應用程式伺服器:Virtual Machine,100 個執行個體 DR
- 應用程式伺服器:Virtual Machine,100 個執行個體 HA

Set-License - 登錄 CA ARCserve RHA

Set-License 指令可讓您使用授權碼來登錄 CA ARCserve RHA。 您需要先具備有效的登錄機碼,再使用此指令。

語法
set-license
參數
機碼

有效的授權碼。

範例:使用授權碼登錄 CA ARCserve RHA

set-license TVC2LF24FTU7G3WJ2QAFMCLGXA5KLPCCYIXTJTWX2MOZFU5GL7EJ3OYZQND7V3G123456

結果:

授權碼已順利登錄
















xo-import-credential

此功能讀取所有指定 XML 檔案中的憑證記錄,並透過指令 Add-Credential 將其新增到連接的 [控制服務]。

語法

xo-import-credential

參數

指定 XML 檔案名稱。

輸入

無。 未導入任何物件至 xo-import-credential。

xo-convertto-securefile

這個指令將純文字 CVS 檔轉換為 XML 檔。

語法

xo-convertto-securefile

參數

已指定來源檔案名稱與目標。

來源必須是 CSV 檔案,並具備以下格式:

主機名稱,

使用者名稱,

密碼

host1,

user1,

pwd1

host2,

user2,

pwd2

輸入

無。 未導入任何物件。

xo-credential - 將字串轉換為 PSCredential 物件

xo-credential 指令可供您將使用者名稱與密碼字串轉換為安全的憑證物件,以便於任何使用 PSCredential 物件做為指令引數的指令內使用。

語法

xo-credential <使用者名稱> <密碼>

範例

xo-credential johnsmith mypword2

控制指令

本節說明可讓您控制複製和 HA 程序的 CA ARCserve RHA PowerShell 指令。

Diff-Scenario - 產生差異報告

Diff-Scenario 指令可以讓您為指定的案例產生差異報告。

重要! 在主要上更新資料時,我們不建議您初始差異報告,因為尚未套用到複本的所有更新都會顯示成差異。

語法
Diff-Scenario [-Name] <String> [-Mode] <String> [-Ignore] <Boolean> 
參數
名稱

您想要為其產生報告之案例的名稱。 您可以使用 Get-Scenario 指令來輸入數個案例的名稱。

無法變更預先定義的配置

同步模式 請輸入下列其中之一:

B=二進位

F=檔案

忽略

在資料比較期間忽略相同名稱與大小的檔案。 請輸入下列其中之一:

1= 是

0= 否

附註:若要在產生差異報告後檢視該報告,請從 [概觀] 頁面中開啟 [報告中心],然後選取必要的報告。

範例:產生差異報告

diff-scenario "File Server 1" F 1

結果:

正在對案例 File Server 1 執行差異報告...
完成!

Export-Scenario - 將案例匯出至指定的位置

Export-Scenario 指令可以讓您將案例匯出至其他位置,方便重複使用。 案例會匯出為 XMC 檔,您可以指定該檔案的位置。

語法
Export-Scenario [-Name] <String> [[-File] [<String>]] 
參數
名稱

案例名稱。

File (選用)

匯出檔的完整路徑。 如果您不指定路徑,檔案將會匯出至目前的目錄,同時將會沿用案例的名稱並以 .xmc 為副檔名。

範例:將案例匯出至指定的位置

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

結果:

案例 File Server 1 順利匯出到 C:\Scenarios

Expose-Snapshot - 顯示快照

Expose-Snapshot 指令可讓您顯示快照。 您可以將快照裝載在未使用的資料夾,以將快照顯示為本機唯讀資料夾,也可以將快照裝載在未使用的磁碟機代號上,以將它顯示為本機唯讀磁碟區。

附註

語法
Expose-Snapshot [-Name] <String> [-Index] <Int32> [-Path] <String> [-Port] <String>
參數
名稱

您要顯示其快照之主機的名稱。

索引

Get-Snapshot 指令所傳回之快照的索引編號。

路徑

想要在其下顯示快照的路徑。 路徑可以是磁碟機代號或完整資料夾路徑。

Port (選用)

用於連線至指定主機的連接埠。 預設連接埠為 25000

範例:將快照顯示為本機唯讀磁碟區

Expose-Snapshot 192.168.1.153 0 E: 25000

結果:

快照 {97127d0b-f1c9-4db5-943d-96c39b712fe6} 裝載為 E:

Import-Scenario - 將案例匯入到管理員

Import-Scenario 指令可以讓您將案例以 XMC 檔的形式,從指定的位置匯入案例。 若要在控制服務之間重新定位案例,或想要使用系統所保留的舊案例,請使用此選項。

語法
Import-Scenario [-檔案] <字串> 
參數
檔案

匯入案例檔的完整路徑。

附註

範例:將案例從指定的位置匯入至管理員中

import-scenario c:\scenarios

結果:

案例 File Server 2 順利匯入來自 c:\scenarios

Mount-Snapshot - 裝載快照

Mount-Snapshot 指令可讓您裝載顯示的快照。 您可以將快照裝載為未使用資料夾的本機唯讀資料夾,也可以將它裝載為未使用磁碟機代號的本機唯讀磁碟區。

語法
Mount-Snapshot [-Name] <String> [[-Index] [<Int32>]] [[-Path] [<String>]] [[-Port] [<String>]]
參數
名稱

您要裝載其快照之主機的名稱。

索引

Get-Snapshot 指令所傳回之快照的索引編號。

路徑

想要在其下顯示快照的路徑。 路徑可以是磁碟機代號或完整資料夾路徑。

Port (選用)

用於連線至指定主機的連接埠。 預設連接埠為 25000

範例:將快照裝載為本機唯讀磁碟區

mount-snapshot 192.168.1.153 0 F:

結果:

快照 {745d6ce9-d880-40bf-a0cb-d4f0114bb0f8} 裝載為 F:

Prepare-Reboot - 準備主機進行維護

Prepare-Reboot 指令可讓您執行維護程序,例如將主機重新開機,或在 Microsoft 叢集節點之間移動群組,而不需在完成這些程序時執行重新同步。

為用於維護做準備的主機必須加入執行中的案例。 每次僅準備一個主機,不過這個主機可以加入多個案例中。 在這些案例中,主機可做為主要及複本伺服器二者。 當主機加入不在執行中的案例時,與此案例所做的準備工作將不會發生。

接收到主機準備重新開機的通知訊息後,您可以重新啟動主機,或在叢集節點之間切換群組。 完成維護程序後,會自動繼續複製程序,而不會重新執行同步。

附註:在準備主機進行維護後,如果您決定不重新啟動主機並繼續執行其案例,則需要先停止再重新執行案例。

語法
Prepare-Reboot [-Name] <String>
參數
名稱

主機名稱。

範例:準備複本主機進行重新開機

Prepare-Reboot QA95-W2K3-EX2

結果:

主機 QA95-W2K3-EX2 準備重新開機

Recover-Scenario - 將遺失的資料從複本復原至主要

Recover-Scenario 指令可讓您復原 [主要] 上遺失的資料,方法是從參與案例的任一 [複本] 主機傳送遺失的資料。 這個動作是以相反方向 (從 [複本] 到 [主要]) 啟動同步程序來加以完成。 啟動 Recover-Scenario 指令時,需要定義欲從中復原資料的 [複本] 主機,以及是否要在復原程序期間刪除存在於 [主要] 而不是 [複本] 上的資料。

重要! 您必須停止複製才能初始復原。

若要確認復原程序已完成,請使用 Get-Events 指令。 收到訊息通知您「復原程序已完成」之後,就可以使用 Run-Scenario 指令重新啟動從 [主要] 到 [複本] 的複製程序。

語法
Recover-Scenario [-Name] <String> [-Host] <String> [-Mode] <String> [-Ignore] <Boolean> [-RemoveMasterFiles] <Boolean> [-RecoveryMode] <String> [-RebootAfterRecovery] <Boolean> 
參數
名稱

案例名稱。

主機

選取從您想從中復原資料的複本主機。

無法變更預先定義的配置

同步模式 請輸入下列其中之一:

B=二進位

F=檔案

忽略

在資料比較期間忽略相同名稱與大小的檔案。 請輸入下列其中之一:

1= 是

0= 否

RemoveMasterFiles

是否要在復原程序期間刪除只存在於主要上的檔案。 請輸入下列其中之一:

1 = 是,只刪除存在於主要上的檔案

0 = 否,只保留存在於主要上的檔案

RecoveryMode

要復原的資料類型。 請輸入下列其中之一:

A = 應用程式資料

S = 系統狀態資料 (僅適用 [系統狀態保護] 選項為作用中時)

B = 兩種類型的資料

預設值為 [A]。

RebootAfterRecovery

是否要在復原程序完成時立即重新啟動主要主機。 請輸入下列其中之一:

1 = 是,重新啟動主要主機

2 = 否,不重新啟動主要主機

範例:復原遺失的資料

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

結果:

復原應用程式資料程序已啟動

Resume-IsAliveCheck - 繼續執行執行中案例的「運作中」檢查

Resume-IsAliveCheck 指令讓您能夠針對指定的執行中 HA 案例,手動繼續執行「運作中」檢查。

語法
Resume-IsAliveCheck [-ScenarioName] <String>
參數
ScenarioName

目標案例名稱。

範例:繼續執行 SQLscenario 的「運作中」檢查

Resume-IsAliveCheck SQLscenario

結果:

繼續執行 SQLscenario 的定期「運作中」檢查。