荒井省三のBlog : PowerShell

[PS]PowerShellリモーティング

shozoa — Tue, 22 Jan 2008 10:44:00 GMT

PowerShell2.0CTPでは、PowerShellリモーティングなるものが提供されています。リモーティングの言葉通り、リモートコンピュータのPowerShellを手元のPowerShellから操作する機能です。このPowerShellリモーティングを使用するには、以下のような前提条件があります。

Windows XP/Windows Server 2003
Windows Remote Managementが必要になります。
Windows Vista
SP1が必要になります。現在公開されているRCで問題はありません。
Windows Server 2008
特に必要なものはありません。

Windows Remote Management(WinRM)の最新版があれば、PowerShellリモーティングを動作させることができます。WinRMとは、WS-ManagementというSOAPベースのプロトコルを使った管理用プロトコルのWindows実装です。WinRMは、Windows Vistaには標準で含まれているのですが、PowerShell2.0で使用するには更新されたバージョンが必要になるのです。
　この準備ができたらPowerShell2.0CTPをインストールしてから、WinRMの設定を行います。設定方法は、PowerShell2.0CTPのリリースノートに記載されている通りで、1)WinRMサービスの起動、2)$PSHome\Configure-Wsman.ps1スクリプトの実行の2つです。

　実際の使い方は、2種類あります。1つ目は、以下の通りです。

PS (1) >Invoke-Exparession hostname -ComputerName コンピュータ名

Invoke-ExpressionにComputerNameパラメータを指定することで、指定したコンピュータ上のPowerShell2.0でhostnameコマンドを実行して、結果をコンソールに表示します。2つ目の方法は、Runspaceオブジェクトを指定します。

PS (2) >$remote = New-Runspace -ComputerName コンピュータ名
PS (3) >Invoke-Exparession hostname -Runspace $remote

New-Runspaceを使ってコンピュータ名に対応したRunspaceオブジェクトを作成します。このRunspaceオブジェクトを指定してコマンドレットを実行するだけです。
つまりPowerShellリモーティングに対応したコマンドレットとは、ComputerNameパラメータとRunspaceパラメータを指定できるように拡張されたコマンドレットであると言えます。この意味で、前回にご紹介したバックグラウンドジョブ(Start-PSJob)などもリモーティングで使用することができます。
　このPowerShellリモーティングは、WinRMのエンドポイントとしてPowerShell.exeを登録しています(この設定が、Configure-Wsman.ps1で行っています)。ですので、IISのようなHTTPサーバーを必要としないのです。また、ComputerNameパラメータには、コンピュータ名を配列で指定することができます。つまり1:Nの通信を行うことができるのです。よって、リモートコンピュータの管理という面では便利かなと私は思っています。
　内部的な動作としては、RemoteRunspaceオブジェクトを作成して、このRemoteRunspaceの中でコマンドレットを実行しています。そしてComputerNameパラメータを指定した場合は、一時的なRemoteRunspaceオブジェクトを作成してコマンドを実行するようになっています。

[PS] 2.0の国際化対応機能

shozoa — Sat, 19 Jan 2008 08:53:00 GMT

　PowerShell2.0でスクリプトの国際化機能が追加されています。どのような機能かと云えば、変数に格納するデータを言語識別子フォルダ(ja-JP、en-USとか)に格納しておくことで、UICultuteによって自動的に適用するデータを選択するというものです。

具体例を使って説明しましょう。以下に実行したいスクリプトファイル（world.ps1）を示します。

# 変数msgTableのデフォルト定義
Data msgTable {
   ConvertFrom-StringData @'
      helloWorld = Hello, World
      errorMsg = You cannot leave the username field blank.
      promptMsg = Please enter your username.
'@
}
param ($language)
Import-LocalizedData -BindingVariable msgTable -Culture $language
$msgTable

次に日本語のデータを定義したファイル(world.psd1)をja-JPフォルダに配置します。

ConvertFrom-StringData @'
      helloWorld = こんにちは。
      errorMsg = ユーザー名は空白にできません。
      promptMsg = ユーザー名を入力してください。
'@

更に内容を英語にしたファイル(world.psd1)をen-USフォルダに配置します。そして以下のように実行するとカルチャによってデータの内容が切り替わります。

PS (1) >.\world ja-JP  #日本語を指定

Name　　　　　　　　　Value
----　　　　　　　　　-----
promptMsg　　　　　　　ユーザー名を入力してください。
helloWorld　　　　　　　こんにちは。
errorMsg　　　　　　　　ユーザー名は空白にできません。

PS (2) >.\world en-US  #英語を指定

Name　　　　　　　　Value
----　　　　　　　　-----
promptMsg　　　　　　　Please enter your username.
helloWorld　　　　　　　Hello, World
errorMsg　　　　　　　　You cannot leave the username field blank.

指定したカルチャによって、データの内容が切り替わっているのを確認することができます。PowerShell 2.0では、現在のカルチャを判断するために$UICultureシェル変数が追加されています。それでは、ここまでに出てきた新しいキーワードやコマンドレットを説明していきます。

Dataキーワード
指定した変数名にスクリプトブロックの実行結果を格納するデータ定義用のキーワードです。スクリプトブロックには、ConverFrom-StringDataコマンドレットの他にif文や一部のシェル変数を利用することができます。
ConverFrom-StringDataコマンドレット
文字列で指定した「名前=値」のペアからハッシュテーブルを作成するコマンドレットです。
Import-LocalizedDataコマンドレット
指定した変数に$UICultureに一致するデータファイルの内容を設定します。実際の動作は、Dataキーワードと同じで、データファイルの中身がスクリプトブロックの中身となります。
デフォルトのデータ
スクリプトファイルの中に記述したDataキーワードがデフォルトの値となります。が、Import-LocalizedDataコマンドレットを指定する場合は、すべてのデータが言語識別サブフォルダに無ければなりません。つまりスクリプトファイル中のDataキーワードは、意味がなくなります。

このような記述を行うことで変数定義をまとめたり、ローカライズをできるようにしたのが、PowerShell2.0の国際化対応となります。

[PS] 2.0におけるWMIの機能強化

shozoa — Thu, 17 Jan 2008 11:16:00 GMT

　PowerShell 2.0では、WMI関係の機能強化が行われています。どのような機能強化かと云えば、以下のようなものがあります。

Get-WmiObject：Impersonation（偽装）などのパラメータが追加された。
Invoke-WmiMethod：WMIクラスのメソッドを呼び出す機能。
Remove-WmiObject：WMIオブジェクトの削除。
Set-WmiInstance：WMIクラスのインスタンスの作成。

　この中から、Invoke-WmiMethodとRemove-WmiObjectをご紹介します。最初にサンプルのコードを以下に記述します。

PS (1) >$note = Invoke-WMIMethod -Path Win32_Process -Name create -Argumentlist notepad.exe
PS (2) >$note


__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 2
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ProcessId        : 4720
ReturnValue      : 0

PS (3) >$ps = Get-WMIObject Win32_Process
PS (4) >$ret = $ps | Where-Object { $_.ProcessId -eq $note.ProcessId }
PS (5) >Remove-WMIObject -InputObject $ret

　1行目のInvoke-WmiMethodでは、WMIのWin32_ProcessクラスのCreateメソッドに引数として「notepad.exe」を指定しています。これで何が行われるかと云えば、メモ帳の起動（インスタンスの作成）が行われます。そして、戻り値からプロセスIDを取得することができます。
　3行目でWin_Processクラスのインスタンスのコレクションを取得します。そして4行目で、1行目で起動したメモ帳のWMIオブジェクトを取得します（もちろん、3行目でWMIクエリーで取得する方法もあります）。
　5行目のRemove-WmiObjectでメモ帳のWMIオブジェクトのインスタンスを削除します。つまり、プロセスを終了させるのです。

　このように作成したWMIオブジェクトのインスタンスを自由に削除することができるように拡張がなされています。
#この例を実行するには管理者権限が必要になります（Remove-WmiObjectが管理者権限を必要とします）」。
#以前のエントリで説明したWin32_ProductクラスはVista SP1で解決されています。

[PS]バックグランドジョブ

shozoa — Wed, 09 Jan 2008 09:24:00 GMT

新年、明けましておめでとうございます。
ご存じの方も多いと思いますが、PowerShell v2のCTPが2007年11月に公開されています。今回は、v2で追加されたバックグラウンドジョブに関して記述したいと思います。バックグラウンドジョブは、文字通りバックグラウンドでコマンドを実行する機能です。この機能に関連したコマンドレットとして、以下が提供されています。

Start-PSJob(ジョブの追加と開始)
Get-PSJob(ジョブの取得)
Remove-PSJob(ジョブの削除)
Wait-PSJob(ジョブの一時停止)
Receive-PSJob(ジョブの実行結果の取得)

使い方は簡単で、「Start-PSJob -Command "コマンド文字列"」を実行することでバックグラウンドジョブが開始されます。Start-PSJobは、PSRemotingJobのインスタンスを返します。このPSJobのインスタンスを取得するのが、Get-PSJobコマンドレットになります。
　実行を開始したPSJobはバックグラウンドで動作しますので、結果を受け取るのに「Receive-PSJob -InputObject $PSJob」を実行します。これでコンソールに実行結果を受け取ることができます。
　PSJobが、PSRemotingJobのインスタンスである点に注意してください。何故なら、v2からPowerShell Remoting(Windows Remote Managementが必須、VistaではSP1が必須)が導入されており、リモートのコンピュータに対する操作をバックグラウンドでできるようになっているからです。それとPowerShellのコマンド実行は、Runspaceオブジェクトのインスタンスを使って実行しますので、バックグラウンドジョブはテンポラリのRunspaceオブジェクトを作成して利用しています。オプションで独自のRunspaceオブジェクト(New-Runspaceコマンドレット)を指定することもできます。
　このバックグランドジョブですが、現時点では管理者権限が必須のようです。一般ユーザー権限で実行したところ、実行が失敗するので管理者権限で試したら、正常に動作しました。

　PowerShell v2 CTPを試される場合に注意していただく点が、2つあります。1つ目は、PowerShell1.0の置き換えになることです。このためインストール前に、PowerShell 1.0をアンインストールする必要があります。最後は、ヘルプに関してです。v2 CTPは英語版のため、日本語OSではヘルプを表示することができません。このため「地域と言語」を英語に設定していただくか、$PSHome\en-USフォルダをja-JPフォルダにリネームしていただく必要があります。

[PS] PowerShellの書籍がまもなく発売になります

shozoa — Wed, 05 Dec 2007 05:03:00 GMT

Blogの更新も滞っていたのは、プライベートでも忙しかったためです。長期に渡ってプライベートの時間でPowerShellの書籍を執筆していました。この書籍もやっと最終局面に入ってきて、残すは最後のチェック作業のみになりました。私は気がつかなかったのですが、Amazonに予約販売で掲載されていました。

タイトル:プログラマブル PowerShell ～プログラマのための活用バイブル～
出版社:技術評論社
ISBN:4774133329
価格：2480円(税抜き)
発売予定日:2008/1/9

サブタイトルが「プログラマのための」となっていますが、スクリプトを記述する人向けとするために可能な限り、文法を重視して記述しました。以下に目次を掲載します。

Capter1. PowerShellとは
1.1. PowerShellの概要
1.2. PowerShellの導入
1.3. コマンド
1.4. その他の機能と特徴
1.5. インタープリタの機能
1.6. まとめ

Chapter2. スクリプトの開発
2.1. PowerShellと.NET Frameworkの関係
2.2. PowerShell固有の癖
2.3. リテラルの定義
2.4. 変数の定義
2.5. データ型
2.6. 演算子(オペレータ)
2.7. フロー制御
2.8. 関数
2.9. ファイル処理
2.10. 例外処理
2.11. デバッグ
2.12. まとめ

Chapter3. PowerShellの使い方
3.1. .NET オブジェクト
3.2. .NET流なファイル処理
3.3. 正規表現
3.4. GUIアプリの開発
3.5. インターネットにアクセスする
3.6. Webサービス
3.7. XMLを使う
3.8. データベースプログラミング
3.9. COMやWMI
3.10. まとめ

Chapter4. PowerShellを活用するために
4.1. タイプシステム
4.2. コマンドレットを作る
4.3. 他の言語から使用する
4.3.1. PowerShellとC#やVB
         ・PowerShellからC#やVBを使用する
         ・C#やVBからPowerShellを使用する
4.3.2. PowerShellとIronPython
         ・PowerShellからIronPythonを使用する
         ・IronPythonからPowerShellを使用する
4.4. スレッド
4.5. セキュリティ
4.6. まとめ

Appendix

執筆時間が長かったため、PowerShell v2.0の最初のCTPも公開されてしまいました。このCTPでは、v1.0を置き換える形でインストールするためにv1.0とv2.0のサイドバイサイドの実行はできませんが、v1.0との互換性を重視しているためv1.0で作成したスクリプトのほとんどが実行できます。

[PS]WMIの取り扱いについて

shozoa — Tue, 02 Oct 2007 11:24:00 GMT

暫く更新が滞っていました。私事で忙しかったせいですが、今回はPowerShellとWMIで気がついた点を記載します。

Windows Vistaを使ってPowerShellでインストールされたソフトウェアの一覧を表示しようとして、WMIのWin32_Productクラスを使ってみました。

PS (1) >Get-WmiObject Win32_Product

Get-WmiObject : エラーです
発生場所 行:1 文字:14
+ Get-WmiObject  <<<< Win32_Product

このようにエラーになってしまいました。一部のソフトウェアが表示される場合もありますが、必ず「Get-WmiObject : エラーです」となってしまいます。色々と調べていくと、Windows Vista のWMIのWin32_Productクラスのバグらしいということが判明しました。この情報はネットニュースのpowershellの中にありました。この内容を見ると既知のバグでVista SP1で修正される予定だと書かれています。じゃあ、他の方法を使わないとWindows Vistaでインストール済みのソフトウェアの一覧を取得できないことになります。で思いついたのが

レジストリを列挙する。
Windows Installer APIを使用する。

という方法です。今回は、Windows Installer APIを使用してみたいと思います。

PS (2) >$wi = New-Object -ComObject WindowsInstaller.Installer
PS (3) >$wi | Get-Member


   TypeName: System.__ComObject

Name                      MemberType Definition
----                      ---------- ----------
CreateObjRef              Method     System.Runtime.Remoting.ObjRef CreateObjRef(
Type requestedType)
Equals                    Method     System.Boolean Equals(Object obj)
GetHashCode               Method     System.Int32 GetHashCode()
GetLifetimeService        Method     System.Object GetLifetimeService()
GetType                   Method     System.Type GetType()
InitializeLifetimeService Method     System.Object InitializeLifetimeService()
ToString                  Method     System.String ToString()

このようにWindows Installer のCOMオブジェクトには、何故か実装されているはずのメンバーが見当たりません。何故かなぁと思って調べていくと、タイプライブラリにcoclassが定義されていないようです。このためにNew-Objectコマンドレットでは、プロパティやメソッドをマップできないようです。解決策はないのかなと思って調べていくと、Abhishek's PowerShell Blogが見つかりました。この内容を参考に以下のようなスクリプトを作成しました。

# COMオブジェクトを作成する
Function Global:GetComObject($ProgID)
{
  New-Object -ComObject $ProgID
}

# プロパティを呼び出す
Function Global:GetPropFromCom($obj, $PropertyName)
{
  # $obj:COMオブジェクト
  # $PropertyName：プロパティ名
  # $Args：パラメータを必要とするプロパティ
  If ( -Not ($obj -is [System.__ComObject]))
　{ Throw "__ComObjectではありません"; Return }
  # System.Typeを取得して、プロパティを呼び出す
  $type = $obj.GetType()
  $type.InvokeMember( $PropertyName, 
[System.Reflection.BindingFlags]::GetProperty ,
 $null, $obj, $args)
}

System.Typeのインスタンスを生成してプロパティをInvokeするというのがこのスクリプトです。これを使って以下のように実行すれば、問題なくインストール済みのソフトウェアの一覧を取得することができます。

PS (10) >$wi = GetComObject WindowsInstaller.Installer
PS (11) >$ps = GetPropFromCom $wi Products
PS (12) >ForEach ($i in $ps)
>> {  GetPropFromCom $wi ProductInfo $i ProductName }
>>
Cardmod_x86 and MSITPintool
Microsoft ASP.NET Futures (May 2007)
Microsoft ASP.NET 2.0 AJAX Extensions 1.0
以下続く

[TechEd] PowerShellについて

shozoa — Tue, 28 Aug 2007 11:06:00 GMT

TechEdでリリース済みの動的言語ということでPowerShellを簡単に説明しました。PowerShellで実行できるコマンドには、以下の4種類があります。

コマンドレット：PowerShell独自のコマンドで「動詞-名詞」というネーミング。
関数：一連の手続きに名前を付けたもの。
スクリプトコマンド：各種のコマンドなどをファイルに保存したもの。
ネイティブコマンド：実行可能プログラム(EXEなど)。

特にネイティブコマンドは重要で、これを使うと「cscript.exe xxxx.vbs」などのWSHのスクリプトをPowerShellの中から実行することができます。つまり、既存のスクリプト資産を移行しなくてもPowerShellで操作できるように配慮されているのです。

デモでお見せした電卓は、以下のようなものです。

これはWindows Formsを使って作成しています。このGUIを作成するときに特徴的な書き方をしているのが以下のようなコードです。

,"C"+1..3+,"/"+4..6+,"*"+7..9+,"-",0,".","=","+"|ForEach-Object {new-button $_}

「new-button」という関数をパイプラインで呼び出しています。パイプラインに渡している配列が、ボタンに表示されている文字列なんです。もちろんFor文やForEach文で作成するという方法もありますが、パイプラインを使ってForループと同じことができるんです。PowerShellって...

デモでは、このようなGUIのサンプルもお見せしましたが、PowerShellでのGUIプログラミングには、鬼門も潜んでいます。何かと言うとPowerShell.exeは、マルチスレッドで動作している点がGUIと相性が悪いのです。たとえばWindows FormsのWebBrowserコントロールなどは、シングルスレッドでないと利用することができないという制約を持っています。このようなコントロールを普通には扱えないのです。もちろん、独自のコマンドレットを使ったりすれば可能ですし、そういうコマンドレットを公開している方達もいらっしゃいます。

慣れてくると便利なツールです。PowerShellって。I-Oリダイレクションもサポートしていますし、CSVなどもサポートしていますから。色々な情報を集めてテキストファイルへ出力とかが簡単なんですね。

[TechEd]明日からTechEd横浜が始まります

shozoa — Mon, 20 Aug 2007 17:25:00 GMT

明日から今年のTechEd Yokohamaが始まります。その準備に追われているのですが、実はまだデモの内容で悩んでいます。作成済みのデモコードを大幅に手直ししたり、新しいデモ内容を作ってみたりしています。というのも私の担当しているセッションの会場がAルームなもので、会場が広いからどのようなモノをお見せしたものかなという悩みがあるからです。このような状況ですので、さっきもデモの内容を確認したりしています。

デモのテーマとしては、以下のようなものを考えています。

現状でできること
DLRのオブジェクト共有
Python ASTとDLR ASTを覗く
IronRuby 1.0アルファでできること

さてさて、どうしよう。

[ps]ByPropertyNameの便利な使い方

shozoa — Sun, 22 Jul 2007 03:37:00 GMT

PowerShellのコマンドレットの引数にByPropertyNameが指定されているものがあります。これを使ったちょっと便利な使い方を牟田口さんが、まとめてくれました。使い方によっては非常に便利だと思います。

牟田口さん、丁寧にまとめて下さって有難うございます。

[MD3] PowerShellについて

shozoa — Fri, 22 Jun 2007 03:53:22 GMT

MD3の説明でPowerShellの関数って、言語拡張のように見せれるので、中々おもしろいという話をしました。この説明で例題に取り上げたのが、「Windows PowerShell in Action」という書籍なのですが、この書籍で提供されるているサンプルをご紹介したいと思います。本自体は、500頁ちょっとありますので、読むのも大変なんですけど(私の堅い枕の1つです)。

Capter8のサンプルに「class.ps1」と「demo-class.ps1」というファイルがあります。詳細は「class.ps1」を見ていただく必要がありますが、「demo-class.ps1」で以下のような記述を行っています。

CustomClass point {
    note x 0
    note y 0
    method ToString {
        "($($this.x), $($this.y))"
    }
    method scale {
        $this.x *= $args[0]
        $this.y *= $args[0]
    }
}


$p = new point

このコードの中で「CustomClass」「note」「method」「new」というキーワードが、実は関数として「class.ps1」で定義されています。クラスという定義方法をPowerShellは提供していませんが、上記のように関数を使用することで、あたかもオペレータを拡張したように見えます。個人的には、これって「おもしろいよなー」と思っています。

この面白ろさというかを皆さんにお伝えしたくて、MD3でPowerShellを取り上げました。それから、DownLoadセンターを見ていてPowerShellを利用する方にお勧めのドキュメントをみつけました。それは、PowerShell Graphical Help Fileです。PowerShellのヘルプのchm形式です。英語で記述されていますが、構文などの全体像を見るのに役立ちます。