瞭解 CA ARCserve RHA PowerShell 指令

入門 › 瞭解 CA ARCserve RHA PowerShell 指令

瞭解 CA ARCserve RHA PowerShell 指令

提供 CA ARCserve RHA PowerShell 可做為使用者使用 CA ARCserve RHA 管理員圖形使用者介面 (GUI)，管理複製程序的替代方式或補充方式。它能擴展並增強舊版所提供的 WS CLI 功能，並且支援 DR 和 HA 作業。

Windows PowerShell™ 是專為系統管理員設計的全新 Windows 指令行 shell 與指令碼環境。這個 shell 包含一個互動式提示，以及可獨立或組合使用的指令碼環境。不像大多數的 shell 會接受及傳回文字，Windows PowerShell 建立在 .NET 通用語言執行時期 (CLR) 及 .NET Framework 上，可接受及傳回 .NET 物件。

Windows PowerShell™ 附隨一組廣泛的內建指令，並使用一致的介面。 CA ARCserve RHA PowerShell 以標準 Windows PowerShell™ 為基礎，並在其中加入了許多與案例相關的指令，稱之為嵌入式管理單元。本指南會說明這些可讓您設定複製案例以及控制和監視複製及切換程序的嵌入式管理單元。 CA ARCserve RHA PowerShell 指令管理的所有案例的外觀和作業方式，與 CA ARCserve RHA 管理員所管理的所有案例的外觀和作業方式完全相同，並且會自動儲存在相同的預設位置：INSTALL_DIR/ws_scenarios

PowerShell 概念

PowerShell Cmdlets

Windows PowerShell 介紹了指令程式的概念 ("command-let")。指令程式是一個簡單、單一功能的指令行工具，內建在 shell 之中，目的為操作物件。您可以依名稱格式來識別指令程式：一個動詞加一個名詞，中間用連字號 (-) 隔開，像是 Get-Help、Get-State 及 Run-Scenario。動詞表示在 Windows PowerShell 中的特定動作；名詞說明物件的特定類型。

在 Windows PowerShell 中，大多數的指令程式都很簡單，而且都是設計來搭配其他指令程式一起使用。例如，"get" 指令程式只會擷取資料、"set" 指令程式只會建立或變更資料、"format" 指令程式只會格式化資料，而 "out" 指令程式只會將輸出導向特定的目的地。

PowerShell 指令程式具有通用參數，但本指南中將不會加以說明。若要取得通用參數的詳細資訊，請輸入：

get-help about_commonparameters

PowerShell 指令程式可以同時具有必要與選用參數。如果遺漏必要的參數，系統會提示您輸入它。如果遺漏選擇性參數，PowerShell 將使用預設值。

物件輸送

Windows PowerShell 提供一個基於物件，而非文字的全新互動式模型。使用物件的主要好處之一是更容易輸送指令，亦即，通過一個指令的輸出，成為另一個指令的輸入。

接收物件的指令可以對它的內容及方法直接採取動作，不必進行任何轉換或操控。您可以依名稱參照物件的內容及方法，而非計算資料在輸出中的位置。

在下列範例中，Get-Scenario 指令的結果會傳送到 Get-Hosts 指令。輸送運算子 (|) 會將左邊的指令結果傳送給右邊的指令，而輸出會傳送至 Format-Table 指令。

PS> Get-Scenario "File Server*" | Get-Hosts | FT -AUTO

案例      名稱          角色   上層         狀態   IP            連接埠

--------      ----          ----   ------         -----   --            ----

File Server 1 192.168.1.152 Master  --            正在執行 192.168.1.152 25000

File Server 1 192.168.1.153 Replica 192.168.1.152 正在執行 192.168.1.153 25000

File Server   192.168.1.152 Master  --            已停止 192.168.1.152 25000

File Server   192.168.1.153 Replica 192.168.1.152 已停止 192.168.1.153 25000

安裝 CA ARCserve RHA PowerShell

若要使用 CA ARCserve RHA PowerShell，您必須安裝 Windows PowerShell 和 CA ARCserve RHA 嵌入式管理單元。

如需 Windows PowerShell 及 CA ARCserve RHA 嵌入式管理單元需求與安裝的詳細資訊，請參閱《CA ARCserve Replication 安裝指南》。

重要！ CA ARCserve RHA PowerShell 和其所連線的 CA ARCserve RHA 控制服務必須具有相同的版本。

執行 CA ARCserve RHA PowerShell

安裝 Windows PowerShell 和 CA ARCserve RHA 嵌入式管理單元之後，就可以從兩個位置執行 CA ARCserve RHA PowerShell：

CA ARCserve RHA PowerShell 捷徑－使用此選項時，可以立即開始使用 CA ARCserve RHA PowerShell 嵌入式管理單元。
Windows PowerShell 捷徑－使用此選項時，需要手動將 CA ARCserve RHA PowerShell 嵌入式管理單元新增至 Windows PowerShell。 (請參閱下列內容。)

重要！ 在 PowerShell 中執行某些指令時，如果您在主要、複本和控制服務主機上設定了不同的密碼，將出現有些作業無法執行或完成的系統錯誤。請於所有主機上使用相同的管理員密碼，以避免發生此問題。

從 CA ARCserve RHA PowerShell 捷徑執行 CA ARCserve RHA PowerShell：

依序選取 [開始]、[程式集]、CA、ARCserve RHA 和 PowerShell，以開啟 CA ARCserve RHA PowerShell。
開啟 CA ARCserve RHA PowerShell 之後，會顯示下列視窗，並列出所有 CA ARCserve RHA PowerShell 嵌入式管理單元：

現在，您必須連線到管理您 CA ARCserve RHA 作業的控制服務。若要執行這個動作，請使用 Connect-XO 指令。

若要從 Windows PowerShell 捷徑執行 CA ARCserve RHA PowerShell：

依序選取 [開始]、[程式集]、Windows PowerShell 1.0 和 Windows PowerShell，以開啟 Windows PowerShell。
Windows PowerShell 視窗隨即顯示。
輸入下列指令，將工作目錄變更至 CA ARCserve RHA PowerShell 嵌入式管理單元 INSTALLDIR：
```
CD 'INSTALLDIR\Powershell Snapin' 
```
目錄隨即變更。
輸入下列指令以安裝 CA ARCserve RHA PowerShell 嵌入式管理單元：
```
.\xo.ps1
```
CA ARCserve RHA PowerShell 嵌入式管理單元已安裝，您可以開始使用它們來連線至控制服務，以管理 CA ARCserve RHA 作業。

使用說明

有許多方法可以在 PowerShell 中獲得協助及其他資訊：

特定指令的說明

說明參數 — 當您對任何指令程式指定 -? 參數時，就不會執行這個指令程式。相反地，Windows PowerShell 會顯示該指令的說明。語法為：
```
<指令名稱> -?
```
若要顯示指令的類型與語法，請輸入：
```
get-command <指令名稱>
```
每個指令都有一個詳細的說明檔。若要存取說明檔，請輸入：
```
get-help <指令名稱> -detailed
```
指令說明檔的詳細檢視畫面包括該指令的說明、指令語法、參數的說明，以及示範該指令用法的範例。
若要顯示指令參數的說明，請在參數提示之後輸入 !?：
```
<參數名稱>: !?
```

可用指令的清單

若要顯示 Windows PowerShell 可用指令的清單，請輸入：
```
get-command
```
若要顯示 CA ARCserve RHA PowerShell 嵌入式管理單元可用指令的清單，請輸入：
```
get-command | where {$_.DLL -match "XO"} | format-table
```
若要顯示針對 XO 指令定義的所有別名清單，請輸入：
```
alias xo*
```

CA ARCserve RHA PowerShell 指令驗證

若要確認安裝 CA ARCserve RHA PowerShell 嵌入式管理單元，請輸入下列指令，並尋找 CA ARCserve RHA PowerShell 嵌入式管理單元：
```
get-pssnapin
```

格式指令輸出

在 Windows PowerShell 中，有數個指令可讓您變更輸出檢視：

Format-List
Format-Custom
Format-Table
Format-Wide

若要變更任何指令的輸出格式，請使用輸送運算子 (|) 將指令輸出傳送至 Format 指令。

例如，下列指令會將 Get-Scenario 指令輸出傳送至 Format-Table 指令。結果是資料會格式化為表格：

PS>get-scenario |Format-table

ID         群組     名稱            類型       主要        狀態   同步  AR

--         -----     ----            ----       ------        -----   ----  --

1123633468 案例 File Server 1   FileServer 192.168.1.152 正在執行檔案  False

1123633497 案例 Exchange Server Exchange   192.168.1.152 正在執行區塊  True

1123633852 案例 File Server 3   FileServer               未知的檔案  False

3848963840 案例 File Server     FileServer 192.168.1.152 已停止的檔案  False

3848982942 案例 File System 1   FileServer QA99-W2K3-EX8 正在執行檔案  False

如需詳細資訊，請使用下列指令來讀取格式指令的說明：

get-help format-list

get-help format-table

get-help format-wide

get-help format-custom

以電子郵件與 CA Technologies 聯繫有關此主題的資訊