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 コマンドラインシェルおよびスクリプト環境です。このシェルには単独または組み合わせて使用できる対話型プロンプトおよびスクリプト環境が含まれています。テキストを受け取って返す通常のシェルとは異なり、Windows PowerShell は .NET 共通言語ランタイム（CLR）および .NET フレームワーク上に構築されていて、.NET オブジェクトを受け取って返します。

Windows PowerShell™ には、一貫性のあるインターフェースを使用した、包括的な組み込みコマンドセットが用意されています。 CA ARCserve RHA PowerShell は標準の Windows PowerShell™ をベースに、スナップインと呼ばれる多数のシナリオ関連コマンドが追加されています。このガイドでは、レプリケーションシナリオの設定、レプリケーションとスイッチオーバーの処理の制御およびモニタを可能にするこれらのスナップインについて説明しています。 CA ARCserve RHA PowerShell コマンドによって管理されるすべてのシナリオは、マネージャによって管理されるシナリオと表示や操作が同じで、自動的に保存されるデフォルトの場所も同じ（INSTALL_DIR/ws_scenarios ）です。

PowerShell の概念

PowerShell Cmdlet

Windows PowerShell では、cmdlet（「command-let」）の概念を導入しています。 cmdlet は、オブジェクトの操作を目的とする、シェルに構築された単純で単機能のコマンドラインツールです。 cmdlet は名前形式で識別することができます。たとえば、Get-Help、Get-State、Run-Scenario など、動詞と名詞がダッシュ（-）で区切られています。動詞は Windows PowerShell の特定のアクションを示し、名詞は特定のオブジェクトのタイプを示します。

Windows PowerShell では、ほとんどの cmdlet の機能は非常に単純で、他の cmdlet と組み合わせて使用されるように設計されています。たとえば、それぞれ、「get」 cmdlet はデータの取得、「set」cmdlet はデータの構築または変更、「format」 cmdlet はデータのフォーマット、「out」 cmdlet は特定の方向への出力のみに使用されます。

PowerShell cmdlet には共通のパラメータがありますが、本書では扱いません。この共通パラメータの詳細を表示するには、以下のコマンドを入力します。

get-help about_commonparameters

PowerShell cmdlet は、必須およびオプションのパラメータを持つことができます。必須パラメータがない場合は、入力を促すプロンプトが表示されます。オプションのパラメータが不足している場合は、PowerShell はデフォルトの値を使用します。

オブジェクトパイプライン

Windows PowerShell では、テキストではなく、オブジェクトに基づいた新しい対話型モデルを提供しています。オブジェクトを使用する大きな利点の 1 つは、コマンドのパイプラインが容易になることです。つまり、あるコマンドの出力を別のコマンドに入力として渡すことができることです。

オブジェクトを受け取るコマンドは、変換や操作をせずに、直接プロパティやメソッドを処理することができます。ユーザは、出力にあるデータの位置を計算するのではなく、オブジェクトのプロパティおよびメソッドを名前で参照することができます。）

以下の例では、Get-Scenario コマンドの結果は Get-Hosts コマンドに渡されます。パイプライン演算子（|）が左側のコマンドの結果を右側のコマンドに送り、出力は Format-Table コマンドに送られます。

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

Scenario      Name          Role   Parent         State   IP            Port

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

File Server 1 192.168.1.152 Master  --            Running 192.168.1.152 25000

File Server 1 192.168.1.153 Replica 192.168.1.152 Running 192.168.1.153 25000

File Server   192.168.1.152 Master  --            Stopped 192.168.1.152 25000

File Server   192.168.1.153 Replica 192.168.1.152 Stopped 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 RHA インストールガイド」を参照してください。

重要： CA ARCserve RHA PowerShell とこの PowerShell が接続されている CA ARCserve RHA コントロールサービスは同じバージョンであることが必要です。

CA ARCserve RHA PowerShell の実行

Windows PowerShell および CA ARCserve RHA スナップインをインストールした後、2 つの場所から 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 コマンドを使用します。

CA ARCserve RHA PowerShell を Windows 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         Group     Name            Type       Master        State   Sync  AR

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

1123633468 Scenarios File Server 1   FileServer 192.168.1.152 Running File  False

1123633497 Scenarios Exchange Server Exchange   192.168.1.152 Running Block True

1123633852 Scenarios File Server 3   FileServer               Unknown File  False

3848963840 Scenarios File Server     FileServer 192.168.1.152 Stopped File  False

3848982942 Scenarios File System 1   FileServer QA99-W2K3-EX8 Running File  False

詳細については、以下のコマンドを実行して、Format コマンドのヘルプを参照してください。

get-help format-list

get-help format-table

get-help format-wide

get-help format-custom

このトピックについて CA Technologies に電子メールを送信する