PowerShellのCOM入門:辞書の作成・存在確認と失敗時の対処

PowerShellのCOM入門の図。ProgIDで作成、Existsで確認、失敗時は中止という3段階。

PowerShellでCOMを試したいのに、Excelの準備や終了処理で手が止まることがあります。この記事ではOffice不要の辞書を使い、部品の作成、値の読取り・変更、失敗時の対処を順に確認します。

COMは、Windowsの部品が持つ機能を呼び出す仕組みです。作成にはNew-ObjectのComObject指定へ部品名を渡します。辞書では、存在しない項目を読むだけで項目数が増える注意点も確認します。

対象はWindows PowerShell 5.1の64ビット環境です。Officeの導入や管理者としての起動は不要で、メール送信やファイル保存も行いません。辞書を操作する各コード欄では、新しい辞書を作って結果を読み比べます。

先に結論

  • COMはWindowsの部品の機能を利用する仕組みです。New-ObjectのComObject指定へ、ProgIDという部品名を渡して作成します。
  • 辞書の存在確認にはExistsを使います。未登録のキーをItemで読むと、値が空でも項目が追加されます。
  • nullへの代入は変数の参照を手放す処理です。Officeの終了や、Office固有の操作が成功することまでは保証しません。

1.Windows PowerShellの版とビット数を確認する

Windows PowerShell 5.1・64ビットで進めます。まずは練習専用の新しい画面を開きます。

操作する場所はWindows PowerShellです。PowerShell 7やコマンドプロンプトとは別の画面です。例では決まった変数名に値を入れるため、作業中の値と混ざらないよう、練習専用に新しく開きます。

コード欄はそれぞれ独立しています。先頭から末尾までを同じ画面で実行し、出力例の欄は貼り付けません。閉じ中かっこの後にも行がある例では、その行まで含めます。

  1. WindowsのスタートメニューでWindows PowerShellを検索し、通常の権限で開きます。端末アプリ内から開く場合も、起動する画面の種類はWindows PowerShellを選びます。
  2. 次のコード欄を3行とも貼り付け、最後のIs64BitProcessの行まで含めてEnterを押します。
  3. 表示された3行を、下の出力例と同じ順番で確認します。

Windows PowerShellの版とビット数を読む

$PSVersionTable.PSVersion.ToString()
$PSVersionTable.PSEdition
[Environment]::Is64BitProcess

実行結果

5.1.26100.9818
Desktop
True

出力は上から、版、PowerShellの種類、64ビットで動作中かどうかです。掲載結果の5.1.26100.9818は版、Desktopは種類、最後のTrueは64ビットで動作中という意味です。

版が5.1で始まり、種類がDesktop、最後がTrueなら、今回の実行条件に合います。ビルド番号まで同じである必要はありません。最後がFalseなら32ビットのため、64ビットの画面を用意して同じ3行で確認します。

掲載結果は2026年11月18日のWindows PowerShell 5.1・64ビット環境で得られたものです。PowerShell 7.6は公式文書の構文照合のみで、実行はしていません。32ビットやWindows以外での実行も確認範囲に含みません。

2.最初は辞書を作り、1件追加して読む

作成・追加・読取りだけを短い例で確認してから、調査用の操作へ進みます。

COMはComponent Object Modelの略で、Windowsの部品の機能をプログラムから利用する仕組みです。ProgIDは部品を指定する名前です。Scripting.Dictionaryという名前を渡すと、メモリ内に辞書を作れます。キーは値を見つけるための識別名で、この例ではpencilというキーに12を登録します。

変数は値を保持する名前で、先頭にドル記号を付けます。dictに入る参照は、辞書を操作するための手がかりです。nullは何も参照していない状態です。値を読む項目をプロパティ、操作をメソッドと呼びます。Addは追加するメソッド、Countは件数を読むプロパティ、Itemはキーを渡して値を読むプロパティです。

tryは本処理、finallyは正常時も失敗時も通る後始末です。ErrorAction Stopは、作成に失敗したまま後続の操作へ進めない指定です。次の欄を最後のnullとの比較まで貼り付け、Enterを押します。出力例は貼り付けません。

辞書を作り1件だけ追加して読む

$dict = $null
try {
    $dict = New-Object -ComObject Scripting.Dictionary -ErrorAction Stop
    $dict.Add('pencil', 12)
    $dict.Count
    $dict.Item('pencil')
} finally {
    $dict = $null
}
$null -eq $dict

実行結果

1
12
True

出力は3行です。最初の1は追加後の件数、次の12はpencilの値、最後のTrueはdictがnullへ戻ったことを表します。赤いエラーが出た場合は成功と読み替えず、第8節の確認順へ進みます。

最後のTrueは即時の資源解放やOfficeの終了を示すものではありません。参照を手放す処理の範囲は第9節で説明します。この短い例の流れを追えたら、次節で値の変更とメンバーの調べ方を加えます。

3.値を変更してから、メンバーの種類を調べる

短い例の次に、値の更新、COM判定、項目と操作の一覧へ進みます。

この欄では辞書を新しく作り直し、pencilの値を12から15へ変更します。ExistsはキーがあるかをTrueまたはFalseで返すメソッドです。Itemへ15を代入すると、そのキーの値を変更します。Itemはキーという引数を受け取るプロパティなので、丸かっこがあってもメソッドとは限りません。引数は機能へ渡す値です。

.NETはPowerShell内部でも利用されるプログラムの実行基盤です。型は、データや機能の種類を表す名前です。角かっこ内に型の名前を書き、二重コロンの後にその型が持つ機能名を書くと、型を通して機能を呼べます。この例のIsComObjectは、dictがCOMへの参照かを調べます。TrueはCOMであるという意味です。

Get-Memberは項目や操作をまとめたメンバーの種類を調べます。InputObjectには調べる辞書、Nameには絞り込む4つの名前を指定します。縦棒は得た結果を次の処理へ渡す記号です。Sort-ObjectのPropertyにNameを指定すると名前順に並びます。

ForEach-Objectは各メンバーを1件ずつ処理します。内側のドル記号と下線は処理中の1件で、Nameは名前、MemberTypeは種類です。fの前にハイフンを付けた書式演算子は、波かっこの0と1の場所へ、右側の名前と種類を順に入れます。

この欄の先頭から、finallyの後のnull比較までをまとめて実行します。すべての行を暗記する必要はありません。まず値の変更までを読み、次にCOM判定とメンバー4件の表示を分けて追ってください。

COM辞書を作り項目と操作を調べる

$dict = $null
try {
    $dict = New-Object -ComObject Scripting.Dictionary -ErrorAction Stop
    [Runtime.InteropServices.Marshal]::IsComObject($dict)
    $dict.Add('pencil', 12)
    $dict.Count
    $dict.Exists('pencil')
    $dict.Item('pencil')
    $dict.Item('pencil') = 15
    $dict.Item('pencil')
    Get-Member -InputObject $dict -Name Add, Count, Exists, Item |
        Sort-Object -Property Name |
        ForEach-Object { '{0}: {1}' -f $_.Name, $_.MemberType }
} finally {
    $dict = $null
}
$null -eq $dict

実行結果

True
1
True
12
15
Add: Method
Count: Property
Exists: Method
Item: ParameterizedProperty
True

出力の1〜5行目は、COMであることを示すTrue、件数1、pencilが存在するTrue、元の値12、変更後の値15です。件数1は最初の追加後に表示した値です。その後、同じキーのItemへ15を代入し、読取り値が15になったことを確認します。

6〜9行目はメンバーの種類です。Methodはメソッド、Propertyはプロパティ、ParameterizedPropertyは引数を受け取るプロパティを表します。引数は処理へ渡す値のことで、Itemにはキーのpencilを渡しています。

最後のTrueは、dictの参照がnullになった確認です。資源が即座にすべて解放されたことや、別のアプリが終了したことを示すものではありません。後始末の範囲は第9節で整理します。

赤いエラーが出た場合は、成功例の出力と読み替えず、第8節の確認順へ進んでください。

4.未登録のキーはItemで読む前にExistsで確認する

Existsは確認だけを行います。未登録キーのItem読取りには、項目を追加する副作用があります。

この欄では新しい辞書を作り、pencilだけを登録します。eraserはまだ登録していないキーです。同じ初期状態から、存在確認だけをした場合と、値を読み取った場合の件数を順に比べます。

Existsはキーの有無を返します。一方、Scripting.DictionaryのItemは、存在しないキーを読むと空の値を持つ項目を作ります。この挙動を、他のすべてのCOM部品に共通するものとして扱わないでください。

次のコード欄を、finallyの閉じ中かっこまで実行します。Itemの戻り値はnullと比較し、空行の代わりにTrueまたはFalseで表示します。値が見えないことと、項目がないことを区別するためです。

存在確認と存在しない項目の読取りを比べる

$dict = $null
try {
    $dict = New-Object -ComObject Scripting.Dictionary -ErrorAction Stop
    $dict.Add('pencil', 12)
    $dict.Count
    $dict.Exists('eraser')
    $dict.Count
    $null -eq $dict.Item('eraser')
    $dict.Count
    $dict.Exists('eraser')
} finally {
    $dict = $null
}

実行結果

1
False
1
True
2
True

1〜3行目は、最初の件数1、存在しないことを示すFalse、確認後の件数1です。Existsで確認しただけでは、eraserは追加されていません。

4〜6行目は、Itemの戻り値がnullと等しいTrue、読取り後の件数2、eraserが存在するTrueです。戻り値が空でも、辞書には項目が追加されています。取得した値だけで辞書の変化を判断しないでください。

存在確認が目的ならExistsを使い、TrueのときだけItemで読みます。各回で新しい辞書を作るため、結果を確認し直すときも、この欄の先頭から実行できます。

5.キーの大小文字は、追加前のCompareModeで決める

Pencilとpencilを同じキーとして扱いたい場合は、データ追加前に比較方法を設定します。

CompareModeは、文字列のキーを比較する方法です。0のバイナリ比較では、この例のPencilとpencilを別のキーとして扱います。1の文字列比較では、この英字の大小を区別せず、同じキーとして扱います。

次の欄では、binaryとtextという変数に別々の辞書を作ります。後者だけ、データを追加する前にCompareModeを1へ設定します。データが入った後に比較方法を変更するとエラーになるため、設定の順序を守ります。

内側のcatchは、エラーが起きたときの処理です。この例では、同じキーを重ねて追加する意図的な失敗を受け止め、案内を表示します。コード欄は、外側のfinallyの閉じ中かっこまで実行します。

キーの大小文字と重複を確かめる

$binary = $null
$text = $null
try {
    $binary = New-Object -ComObject Scripting.Dictionary -ErrorAction Stop
    $binary.CompareMode
    $binary.Add('Pencil', 12)
    $binary.Exists('pencil')
    $text = New-Object -ComObject Scripting.Dictionary -ErrorAction Stop
    $text.CompareMode = 1
    $text.Add('Pencil', 12)
    $text.Exists('pencil')
    try {
        $text.Add('pencil', 99)
    } catch {
        '同じキーは追加できません。'
    }
    $text.Count
    $text.Item('Pencil')
} finally {
    $binary = $null
    $text = $null
}

実行結果

0
False
True
同じキーは追加できません。
1
12

1〜3行目は、既定のCompareModeが0であること、大小を区別した場合のFalse、区別しない場合のTrueです。Pencilとpencilの扱いが、辞書の設定によって変わっています。

4行目は重複追加に失敗した案内です。続く件数1と値12から、99で上書きされていないことが分かります。Addは新しいキーを追加する操作で、既存値の変更とは役割が違います。

既存値を変更する場合はExistsで存在を確認し、第3節のようにItemへ代入します。比較方法を変えてやり直す場合は、新しい辞書を作ります。なお、今回の英字の結果を、あらゆる言語の文字へ一般化はしません。

6.作成に失敗したら、後続の操作へ進まない

架空のProgIDを指定し、作成失敗時にcatchの案内へ進む流れを確認します。

次のPostWordPress.MissingCom5367は、失敗経路を確認するための架空のProgIDです。部品の登録やアプリの導入は行いません。probeは、作成を試す対象への参照を保持する変数名です。

ErrorActionのStopで作成失敗を停止するエラーとして扱い、catchの案内へ進めます。作成できていない対象を、そのまま操作し続けないための指定です。finallyでは、成功・失敗のどちらでもprobeの参照を手放します。

この欄も、finallyの閉じ中かっこで止めず、最後のnullとの比較まで実行します。案内の表示と、最後の比較結果を分けて確認してください。

未登録のProgIDを指定したときは後続操作を止める

$probe = $null
try {
    $probe = New-Object -ComObject PostWordPress.MissingCom5367 -ErrorAction Stop
    '作成できました。'
} catch {
    '作成できません。ProgIDとアプリの登録状況を確認してください。'
} finally {
    $probe = $null
}
$null -eq $probe

実行結果

作成できません。ProgIDとアプリの登録状況を確認してください。
True

出力は「作成できません。ProgIDとアプリの登録状況を確認してください。」という案内と、最後のTrueです。「作成できました。」という行は出ません。作成失敗がcatchへ渡されたことを確認できます。

この案内は、コードで用意した一般的な中止案内です。表示された一文だけで、登録不足などの個別の原因まで特定できたわけではありません。最後のTrueも、probeがnullであることを示す結果です。

7.件数・存在確認・取得値を表で見比べる

値が空かどうかに加え、件数とキーの存在を確認すると、読取りによる変化を見分けられます。

次の表は、第3〜6節の結果を判断に使う形で整理したものです。各コード欄は新しく対象を作るため、前の欄の値を引き継いで読む必要はありません。同じ欄の操作前後を比べます。

表の右端には「結果と判断」があります。画面からはみ出す場合は、表の中を横へスクロールして確認してください。コードの長い行も、コード欄内を横へ動かして読みます。

確認 操作・条件 結果と判断
作成と変更 pencilを12から15へ更新 Countは1、取得値は15
追加しない確認 Existsでeraserを確認 False、Countは1のまま
項目の読取り 未登録eraserをItemで読む 空だがCountは2へ増える
大小文字を区別 CompareMode=0でPencil/pencil ExistsはFalse
大小文字を同一視 CompareMode=1でPencil/pencil ExistsはTrue、重複Addは失敗
未登録のProgID 架空名を作成 catchの案内、最後のnull確認はTrue

「作成と変更」は第3節、「追加しない確認」と「項目の読取り」は第4節に対応します。「大小文字を区別」「大小文字を同一視」は第5節、「未登録のProgID」は第6節の結果です。

特に見比べたいのは、ExistsとItemを使った後の件数です。どちらも未登録のeraserを対象にしていますが、Existsの後は1のまま、Itemで読んだ後は2になります。空の戻り値だけでは、この違いを判断できません。

8.結果が違う・実際のアプリを作れない場合の確認順

実行範囲、部品名、製品の前提、対応環境の順に確認します。

練習の結果が違う場合は、まず実行した範囲と初期状態を確認します。コードの途中から再実行すると、掲載結果と同じ条件にならないことがあります。今回の辞書の例では、欄全体を実行し直して確認できます。

実際のアプリの作成失敗は、辞書の結果と分けて判断します。辞書を作れても、別の製品が導入・登録されていることや、その製品に合う実行条件までは確認できません。

  1. 今回の練習で結果が違う場合は、第1節の環境を確認し、対象のコード欄を末尾まで実行し直します。途中からの再実行や、別の欄の結果との取り違えを確認します。
  2. 実際のアプリで作成に失敗する場合は、指定したProgIDの綴りと、対象製品の導入・COM登録を確認します。
  3. 対象製品の対応条件と、PowerShellの版・32/64ビットの組合せを確認します。ビット数の影響は部品の種類によるため、一律の原因にはしません。
  4. 解決しなければ、発生時刻、エラー内容、ProgID、PowerShellの版とビット数を控え、アプリの管理者へ確認します。機密情報を含むエラーは、そのまま公開しないでください。

今回の練習のために、管理者として起動し直す、部品の登録などWindows側の設定を書き換える、無関係なプロセスを終了する、といった対処は必要ありません。

作成に失敗した場合は、参照を得たものとして後続の操作へ進まないでください。実際の製品の設定変更が必要かどうかは、その製品の前提とエラー内容を確認して判断します。

9.nullへの代入とOfficeの終了を区別する

変数の参照を手放す処理を、ExcelやOutlookの終了保証へ流用しません。

今回のfinallyで行うnullへの代入は、変数から辞書などへの参照を手放す処理です。参照が空になったことを確認できても、すべての資源がその瞬間に解放されたという意味ではありません。

ExcelやOutlookのCOMは、アプリ本体を扱います。辞書と同じ作成方法が書けても、保存や終了まで同じ手順で済むとは限りません。別の作業中アプリまで終了させない配慮も必要です。

ReleaseComObjectは、.NETという実行基盤側で管理されるCOMへの参照を明示的に解放する機能です。共有された参照への誤用は別の処理を壊す場合があるため、変数の一括解放やプロセスの強制終了を汎用の後始末にはしません。

Microsoftは、サーバー側や非対話環境での無人Office自動化を推奨・サポートしていません。時刻などを指定して処理を起動するWindowsのタスクスケジューラでも、ログオン状態や対話の有無を含む条件確認が必要です。

Office固有の検証へ進む場合は、辞書の成功をそのまま当てはめず、次の条件を別に用意します。

  • 対象製品の対応環境と、ログオン状態などの実行条件。
  • 練習用ファイル、保存先、上書きの条件、保存しない場合の扱い。
  • アプリ固有の終了方法と、別の作業中アプリを巻き込まない確認方法。

本記事の実行結果は、Windows PowerShell 5.1・64ビットでの環境確認、辞書の操作4例、作成失敗1例です。Officeの起動・保存・メール送信、PowerShell 7、32ビット動作は未実行です。

練習用に開いた画面を閉じれば、その画面で作った変数は残りません。今回の例ではファイル、COM登録、権限、テーマ設定を変更しないため、それらを戻す操作はありません。