それ、レプリケーションでよろしく。UDPともども。

■１： まず、実行ポリシーをチェック

ひょっとしたら、前回の記事と同じことをやっても、「ヘルプも見られないし、何も実行できないよ！」という方がいらっしゃるかもしれません。そんな時には以下のコマンドを実行して、スクリプト実行ポリシーがどのように設定されているか確認ください。Windows PowerShell ではセキュリティ確保のため、スクリプトの使用を制限できるようになっています。（詳細は→ Windows PowerShell スクリプトの実行ポリシーの表示）

PS > Get-ExecutionPolicy 

で、この結果が「Restricted」とかだと、スクリプトを実行する事が出来ないという事になります。そこで、実行できるようにポリシーを変更します。皆様の所属される組織のセキュリティルールに従い、適切なポリシーを設定してください。以下、設定例です。（参考：Windows PowerShell スクリプトの実行ポリシーの変更）

PS > Set-ExecutionPolicy RemoteSigned 

■２： 次に、パスワード ファイルを作っておく

前回の実行例では Arcserve UDP コンソールにログインするユーザーのパスワードをパスワード ファイルを使って指定しました。直接パスワードを入力するオプションもありますが、スクリプト中に平文でパスワードを残しておくのはあり得ないと思いますので、あらかじめ暗号化されたパスワードファイルを作っておいてください。

パスワード ファイルを作成するためのコマンド実行例はこちら↓。スクリプトを実行するユーザーでこのコマンドを実行（※1）します。パスワードは「xxxxxxxx」で、「C:\pass」という名前のパスワードファイルを作っています。

<Arcserve UDP 7.0 以降（※2）>

PS > cd 'C:\Program Files\Arcserve\Unified Data Protection\Management\PowerCLI'
PS > $SecurePassword = Read-Host -AsSecureString (ここで Enter キーを押す)
******** (←パスワードを入力。終わったら Enter キーを押す)
PS > .\UDPPowerCLI.ps1 -Command CreatePswFile -Password $SecurePassword -PasswordFile C:\pass  

<Arcserve UDP v6.x>

PS > cd 'C:\Program Files\Arcserve\Unified Data Protection\Management\PowerCLI'
PS > .\UDPPowerCLI.ps1 -Command CreatePswFile -Password xxxxxxxx -PasswordFile C:\pass

■３： いよいよスクリプトを作る

といっても、特別難しい事はなく、メモ帳を開いて、前回手作業で入力したコマンドを書くだけです。以下はサンプルです。 

1: cd ‘C:\Program Files\arcserve\Unified Data Protection\management\PowerCLI’   

2: .\UDPPowerCLI.ps1 -Command Backup -UDPConsoleServerName UDPv6 -UDPConsoleProtocol https -UDPConsolePort 8015 -UDPConsoleUserName administrator -UDPConsolePasswordFile C:\pass -planName 'Windowsサーバ' -BackupJobType Incr

※ 左端の数字は行数です。スクリプト作成時は無視してください。

書いたら、拡張子を「.ps1」にして PowerShell Script ファイルとして保存してください。 

■４： スクリプトを外部から実行する

作ったファイルをさっそく実行してみたいところですが、batファイルのようにダブルクリックしてもメモ帳で開かれるだけでなにも起こりません。PowerShell はセキュリティ上の目的で、ダブル クリックでは実行できないようになっているんです。そこで、実行するときには以下のように Windows PowerShell にスクリプトファイルのパスを渡す必要があります。 

例として、Windows タスク スケジューラでスクリプトを実行するときの設定はこんな感じ。[プログラム/スクリプト]にはWindows PowerShell の実行ファイルである「Powershell.exe」を指定します。で、今回作ったスクリプトは[引数の追加]の方で指定します。

今回はWindows タスク スケジューラを使用しましたが、他のジョブ管理ツールで実行する際も同じように設定します。

以上、2回に分けて Arcserve UDP のコマンドライン インターフェース をご紹介しました。実は、サポートの公式ページにも詳細がまとめられています。この機能を使う方はぜひこちらもご覧ください。 

arcserve-KB : PowerShell を使用した Arcserve UDP v6.0 ノードのバックアップ方法

arcserve-KB : UDPPowerCLI コマンドの戻り値について

※1 DPAPI という API を使ってパスワードを暗号化しているため、暗号化時のユーザーでなければパスワードを復号できません。例えばタスク スケジューラーで SYSTEM アカウントを使ってスクリプトを実行させたい、という場合は注意が必要です。

※2 Arcserve UDP 7.0 以降ではパスワードファイルの作成方法が v6.x から若干変わりました。
Arcserve UDP 7.0 における PowerShell 利用時のパスワード設定方法