nWOLc マニュアル：nWOLのコンソールコマンド

nWOL Version 2.1.12 をリリースしました! (2025/2/16) (ダウンロードはこちら)

Version2ではこれまでの機能に加え、以下の機能が追加されています。(一部機能有償)
・ホストのグループを定義可能。メイン画面でグループを選択して表示することができます。
・グループごと、または、ホストごとに、ping間隔、表示色、サウンドなどの個別設定ができます。
・ホスト名ダブルクリックなどから、リモートデスクトップ、シャットダウン等のコマンド実行が可能。
・独自のバッチファイルを登録することで、コマンドを自由に追加可能。認証支援機能を提供。
・コマンド実行を管理するコマンドコンソール機能。
・メイン画面の詳細デザインを設定可能。複数のデザインを登録可能。
・ログ記録機能。

nWOLcの概要

nWOLc.exe は、nWOLのコンソールコマンドです。nWOLに登録されているホストに対して、マジックパケット送信、ホスト状態確認処理、起動完了待機処理を、コマンドラインから実行できます。Version2 からはnWOLに登録されているコマンドも実行できるようになっています。バッチファイルやタスクスケジューラなどから処理を起動させることができるようになります。

nWOLのパッケージに同梱されており、インストーラを使ってインストールすると、nWOLと同じフォルダ(C:\Program Files\nWOL)に置かれます。

nWOLc.exe で実行できるオプションは以下の通りです。

nWOLc: nWOL Console Command (Version 2.10.X)
                
-l ["regex"]                       List all or regex-matched hosts
-f ["regex"]                       List all or regex-matched hosts with full information
-a                                 Send magic packet to all WOL-capable hosts
-h hostnames...                    Send magic packet to specified hosts
-r "regex"                         Send magic packet to regex-matched WOL-capable hosts
-g groupnames...                   Send magic packet to all WOL-capable hosts in groups
-m mac [ip [mask]]                 Send magic packet
-p hostname                        Check status of a host(or IP) (retcode=0 if online)
-w hostname [waitsec]              Wait for a host(or IP) to come online (retcode=0 if online)
-arp                               Extend the -p and -w to include an ARP-based determination logic
-cmda commandname                  Run command for all hosts
-cmdh commandname hostnames...     Run command for specified hosts
-cmdr commandname "regex"          Run command for regex-matched hosts
-cmdg commandname groupnames...    Run command for all hosts in groups
-ipname [sec]                      Try IPNAME resolution when -cmdX. (sec:timeout, default=3)
-t sec                             Set ping timeout in seconds for the -p or -w options (default=1)
-u port                            Specify the UDP port number for the destination of the Magic Packet
-i                                 Ignore case for the -l, -f, -r, or -cmdr options
-c filename                        Configuration file name(absolute path or user name)
-o filename                        Redirect console output to a file(Absolute path)
-v                                 Verbose mode
-n                                 No output messages
-?                                 Help

オプション解説

-l ["regex"] ：ホスト名一覧の表示

nWOLに登録されているホスト名の一覧を表示します。

nwolc -l

nwolc -l "^a.*z$"

nwolc -l server -i

• regexが指定されない場合はnWOLに登録されている全てのホストが表示されます。
• 正規表現は、” ” で囲んでください。
• nWOLで使用する正規表現の詳細については、以下のマイクロソフトのページを参照してください。
  「Regular Expression Language - Quick Reference」（マイクロソフトのページ）

-f ["regex"] ：ホスト詳細情報の一覧表示

コマンド指定方法は -l と同じです。各ホストごとに、詳細情報を表示します。

-a ：全てのホストにマジックパケットを送信する

nWOLに登録されているホストのうち、WOLが許可されている全てのホスト（WOL ModeがDisable以外のホスト全て）に対してマジックパケットを送信します。

nwolc -a

-h hostnames... ：ホスト名を指定してマジックパケットを送信する

nWOLに登録されているホスト名を指定してマジックパケットを送信します。

起動中(Online)のホストにも送信されます。

WOLが許可されていないホストは除外されます。

nwolc -h Server1 "File Server"

• ホスト名に空白を含むような場合は、" " で囲んでください。
• ホスト名は空白で区切って複数指定できます。
• 大文字小文字を区別します。

-r "regex" ：正規表現にマッチする全てのホストにマジックパケットを送信する

nWOLに登録されているホスト名が、指定した正規表現にマッチする全てのホストにマジックパケットを送信します。

起動中(Online)のホストにも送信されます。

WOLが許可されていないホストは除外されます。

nwolc -r ^[0-9]

nwolc -r PC$ -i

• 正規表現に空白を含む場合などは、” ” で囲んでください。
• nWOLで使用する正規表現の詳細については、以下のマイクロソフトのページを参照してください。
  「Regular Expression Language - Quick Reference」（マイクロソフトのページ）

-g groupnames... ：グループのホストにマジックパケットを送信する

nWOLに登録されているグループに属する全てのホストにマジックパケットを送信します。

起動中(Online)のホストにも送信されます。

WOLが許可されていないホストは除外されます。

nwolc -g Group1

nwolc -g Group1 Group2

-m mac [ip [mask]] ：マジックパケットを送信する

MACアドレスを直接指定してマジックパケットを送信します。

nwolc -m abcdef123456

nwolc -m abcdef123456 192.168.1.20

nwolc -m abcdef123456 192.168.10.20 255.255.255.0

nwolc -m abcdef123456 192.168.10.20 24

nwolc -m abcdef123456 192.168.10.20/24

nwolc -m abcdef123456 192.168.10.255

nwolc -m abcdef123456 mypc.mydomain.com

nwolc -m abcdef123456 mypc.mydomain.com 24

• 同一LAN内のホストに対しては、MACアドレスのみ指定すれば送信できます。
• MACアドレスのみ指定した場合、接続されている全てのネットワークIFからマジックパケットが送信されます。複数のネットワークIFが接続されているが、送信先ホストが存在するネットワークIFからのみパケットを送信したい場合は、IPアドレスを指定してください。（ネットマスクは指定する必要はありません。）
• ルータを経由した先のホストにマジックパケットを送信する場合は、送信先ホストのIPアドレスとネットマスクを指定するか、送信先ホストの存在するNWのディレクティッドブロードキャストアドレスを指定する必要があります。
• IPアドレスのパラメータ部分には、DNS名を指定することができます。
• IPアドレスの検索順序は
  (1)IPアドレス形式(192.168.1.10等)として解釈
  (2)DNS名として名前解決
  の順で行われます。
• DNS名前解決では、nWOLで指定されているDNSサフィックスリストが使用されます。
• ディレクテッドブロードキャストアドレスとは、IPアドレスのホスト部の全てのビットを１にしたアドレスです。
  参考記事：「ブロードキャストアドレスの種類を知る 」 (atmarkIT記事)

-p hostname ：ホストの起動状態を調べる

指定されたホストに ping を送信して、ホストの起動状態を調べます。

-arpオプションが設定された場合は、pingレスポンスによる判定に加え、ARPを利用した判定も行われます。詳細は -arp オプションの解説をご覧ください。

nwolc -p Server1

nwolc -p 192.168.1.6

nwolc -p mypc.mydomain.com

nwolc -p mypc.mydomain.com -arp

nwolc -p Server1 -t 3

• 起動状態であった場合は戻り値 0、それ以外の場合は戻り値 1 となります。
• ping のタイムアウトはデフォルトで１秒です。
• IPアドレスの検索順序は、
  (1)nWOLに登録されているホスト名から検索
  (2)IPアドレス形式(192.168.1.10等)として解釈
  (3)DNS名として名前解決
  の順で行われます。
• DNS名前解決では、nWOLで指定されているDNSサフィックスリストが使用されます。

※参考：ホストの起動状態はpingコマンドでも確認できますが、Windowsのpingコマンドの場合、「宛先に到達できない(送信先アドレスへのルートがない)場合」についても、戻り値が 0（正常） となります。nwolc -p の場合、正常に応答が返ってきた場合以外は全て戻り値が 1 となります。

-w hostname [waitsec] ：ホストが起動状態になるまで待機する

指定されたホストにpingを継続的に送信し、正常な応答があるまで繰り返します。指定されたホストが起動状態になるのを待機します。待機時間は最大waitsec秒となります。waitsecを指定しない場合、ホストが起動するまでコマンドが終了しませんのでご注意ください。

-arpオプションが設定された場合は、pingレスポンスによる判定に加え、ARPを利用した判定も行われます。詳細は -arp オプションの解説をご覧ください。

nwolc -w Server1 60

nwolc -w Server1

nwolc -w 192.168.1.6 60

nwolc -w 192.168.1.6 60 -t 3

nwolc -w 192.168.1.6 60 -arp

nwolc -w mypc.mydomain.com 60

nwolc -h Server1 -w Server1 60

nwolc -a -w Server1

• 起動状態になった場合、戻り値は 0 となります。待機時間が過ぎた場合など、それ以外の場合は 1 となります。
• -w は、-a, -h, -r, -g, -m と同時に指定することができます。その場合、マジックパケットを送信した後、指定されたホストが起動するまで待機します。
• -a, -h, -r, -g, -m と同時に使用した場合、-a, -h, -r, -g, -m の実行結果にかかわらず、-w の実行結果が戻り値として返されます。
• IPアドレスの検索順序は、
  (1)nWOLに登録されているホスト名から検索
  (2)IPアドレス形式(192.168.1.10等)として解釈
  (3)DNS名として名前解決
  の順で行われます。

-arp ：ARPを利用したホスト状態判定を行う

-p オプション、または、-w オプション実行時、-arpオプションを付けることで、ping によるホスト状態判定に加え、ARPを利用したホスト状態判定を行います。

ARPを利用したホスト状態判定を行うことによって、pingレスポンスを返さないホストについても状態判定が可能になります。

詳細は、「ARPを利用したホスト状態判定方法の改善について」をご覧ください。

nwolc -p mypc.mydomain.com -arp

nwolc -w 192.168.1.6 60 -arp

-cmda commandname ：全てのホストに対してコマンドを実行する

nWOLに登録されている全てのホストに対して、nWOLに登録されているコマンドを実行します。

ホストの状態によらず、全てのホストに対して実行されます。（nWOLの動作と異なります）

nwolc -cmda Command1

-cmdh commandname hostnames... ：ホスト名を指定してコマンドを実行する

指定されたホストに対して、nWOLに登録されているコマンドを実行します。

ホストの状態によらず、指定された全てのホストに対して実行されます。（nWOLの動作と異なります）

nwolc -cmdh Command1 Server1

nwolc -cmdh Command1 Server1 Server2

-cmdr commandname "regex" ：正規表現にマッチする全てのホストに対してコマンドを実行する

正規表現にマッチする全てのホストに対して、nWOLに登録されているコマンドを実行します。

ホストの状態によらず、指定された全てのホストに対して実行されます。（nWOLの動作と異なります）

nwolc -cmdr Command1 ^[0-9]

nwolc -cmdr Command1 PC$ -i

• 正規表現に空白を含む場合などは、” ” で囲んでください。
• nWOLで使用する正規表現の詳細については、以下のマイクロソフトのページを参照してください。
  「Regular Expression Language - Quick Reference」（マイクロソフトのページ）

-cmdg commandname groupnames... ：グループに属する全てのホストに対してコマンドを実行する

nWOLに登録されているグループに属する全てのホストに対して、nWOLに登録されているコマンドを実行します。

ホストの状態によらず、指定されたグループの全てのホストに対して実行されます。（nWOLの動作と異なります）

nwolc -cmdh Command1 Group1

nwolc -cmdh Command1 Group1 Group2

-ipname [sec] ：NWOL_IPNAME環境変数に設定するホスト名解決を行うか指定する

nWOLcは、コマンド実行時に、コマンドに対して、環境変数を渡します。環境変数NWOL_IPNAME には、ホスト名（IPアドレスへの名前解決が可能である名前）が取得できる場合はそのホスト名が設定され、それ以外の場合はIPアドレスが設定されます。

このホスト名を取得するためには、IPアドレスを解決しホスト名を取得する必要があります。nWOLcでは、デフォルトでは、この解決は行われませんので、解決を行う場合 -ipnameオプションを指定します。

secには、この解決を行う際のタイムアウト秒数を指定します。デフォルトは3秒です。

nwolc -comh Command1 Server1

nwolc -comh Command1 Server1 -ipname

nwolc -comh Command1 Server1 -ipname 5

-t sec ：pingのタイムアウト秒数を設定する

-p, -w で実行される ping のタイムアウト秒数を設定します。

nwolc -p Server1 -t 3

• -p または -w とともに指定する必要があります。
• ping のタイムアウトはデフォルトで１秒となっています。
• 今どきのネットワークであれば、ping の応答は１秒以内で返ってくると思いますが、pingの応答が１秒以上かかってしまうことがあるような場合、このオプションで適切な値に設定してください。

-u port  : Magic Packetの送信先のUDPポート番号を指定する

-a, -h, -r, -g, -m でマジックパケットを送信する際、マジックパケットの送信先のUDPポート番号を指定します。

nwolc -a -u 7000

nwolc -h Server1 -u 7000

nwolc -m abcdef123456 192.168.10.20/24 -u 7000

nwolc -m abcdef123456 mypc.mydomain.com 24 -u 7000

-i ：正規表現で大文字小文字を区別しない

-l, -f, -r, -cmdr で、正規表現の処理を行う際に、大文字小文字を区別しない設定にします。

-c filename ：設定ファイル名を指定する

読み込む設定ファイルを指定します。パラメータには設定ファイルの絶対パス名、または、ユーザ名を指定します。

ユーザ名を指定した場合、設定ファイルは C:\Users\<ユーザ名>\AppData\Roaming\nWOL\nWOL2.conf となります。Version2の conf ファイルが参照されます。実行前に、nWOLを起動して、nWOL2.confを作成しておく必要がありますので、ご注意ください。

読み込む設定ファイルには適切なアクセス権が付与されている必要があります。

nwolc -c "c:\Users\User Name\AppData\
Roaming\nWOL\nWOL2.conf" -l

nwolc -c "User Name" -l

-o filename ：コンソール出力をファイルにリダイレクトする

コンソール出力をファイルにリダイレクトします。ファイル名は絶対パスでなければなりません。ファイルが存在する場合、追記モードで出力されます。

nwolc -o "c:\Windows\Temp\out.log" -l

-v ：処理状況を表示する

処理状況を示すより多くのメッセージを表示します。

-n ：メッセージの表示をしない

メッセージの表示を一切行わないようにします。

-? ：ヘルプの表示

ヘルプを表示します。オプション無しで nWOLc を実行してもヘルプが表示されます。

戻り値

nWOLc の戻り値は、基本的には、正常終了は 0、何らかのエラーがあった場合(コンソール表示に "Error:" が表示された場合)は１となります。

-p -w の場合は、ホストが起動中であれば 0、それ以外の場合は 1 となります。

また、-a -h -r -g -m いずれかと -w が同時に指定された場合、 マジックパケット送信処理でエラーが表示されていても、-w の戻り値が返されます。

ARPを利用したホスト状態判定の動作について

nWOL(GUI版)では、ホストの状態判定は、pingによる判定と、ARPを利用した判定の両方を組み合わせて実行しています。

一方、nWOLcでは、-pオプション、 -wオプションの実行時は、Version1 の仕様を踏襲し、pingのみによる判定が行われ、-arpオプションを付加することで、ARPを利用した判定が行われるようになります。

-arp オプション指定時の注意点としては、「ホストが実際に停止してから、15秒～45秒程度までonlineと判定されてしまう」という点があります。15秒～45秒程度Offline判定が遅れることになりますので、ご注意願います。

詳細については、「ARPを利用したホスト状態判定方法の改善について」をご覧ください。

コマンド実行オプション実行時の注意点

nWOL Version2 では、コマンド実行機能が追加となっています。nWOLc では、-cmda, -cmdh, -cmdr, -cmdg オプションでコマンドを実行できるようになっています。

nWOLcからコマンドを実行する際の注意点を以下にまとめます。

• nWOLcのコマンド実行オプションで、複数のホストに対してコマンドを実行する場合、実行は、各ホストに対する処理が1つづつシーケンシャルに行われます。途中のホストの処理が滞った場合は、そのホストに対するコマンド実行が完了するまで、以降のホストに対する処理は行われません。
• コマンドによっては、資格情報の入力を促されることがあります。入力が行われるまで処理は中断されます。
• 複数のホストに対してコマンドを実行する際、資格情報の入力を促されたがそのホストの処理を中止する場合、User Name または Password の入力時に、Ctrl-Z (^Z) を入力してEnterを押してください。そのホストの処理が中断され、次のホストの処理に移ります。以降の全てのホストの処理を中止したい場合は、Ctrl-C を入力してください。
• nWOLc は、Ctrl-C で中断することができます。中断した以降のホストに対してはコマンドは実行されません。
• 各コマンドに渡される環境変数 NWOL_HOSTNAME は記号文字が "_" に置換されます。この置換を行わない場合は、nWOL(GUI版)の設定で、「環境変数の文字エスケープを行わない」をチェックしてください。
• 環境変数 NWOL_IPNAME のアドレス→名前 解決を行う場合は、-ipname オプションを付けてください。名前解決できない場合は、タイムアウトまでデフォルトで3秒かかります。
• コマンド実行オプションはnWOLのライセンスが正しく登録されていないと実行できません。

-m, -p, -w オプションは nWOLc.exe 単独でも使用可能

nWOLc.exe は基本的には nWOL で登録されている情報（ホスト、グループ、コマンド）に対して処理を行いますが、-m オプション、および、-p, -w をIPアドレス指定とした場合については、nWOLの設定情報を使用しないため、nWOLc.exe 単独で使用できます。

nWOL、nWOLc で使用する正規表現の仕様

nWOL, nWOLcで使用する正規表現の仕様については、以下のリンクを参照してください。

「Regular Expression Language - Quick Reference」（マイクロソフトのページ）

Related Articles

• 記事：nWOL version 2.1.12 をリリースしました (2025/2/16)
• 記事：nWOL version 1.7.81 Released (2024/8/18)
• 記事：nWOL version 1.7.81 をリリースしました (2024/8/18)
• 記事：WiresharkでマジックパケットがDISCARDと表示される (2024/5/2)
• 記事：nWOL version 1.7.77 Released (2023/7/8)
• 記事：nWOL version 1.7.77 をリリースしました (2023/7/8)
• 記事：LinuxでWake on LANを設定する方法 (2023/1/29)
• 記事：nWOL version 1.7.75 Released (2022/7/9)
• 記事：nWOL version 1.7.75 をリリースしました (2022/7/9)
• 記事：nWOL version 1.7.73 Released (2022/5/29)
• 記事：nWOL version 1.7.73 をリリースしました (2022/5/29)
• 記事：インターネットから自宅のPCを遠隔起動する方法 (2022/5/21)
• 記事：バッチファイルでWake on LANのマジックパケットを送信する (2021/8/29)
• 記事：nWOL version 1.7.59 をリリースしました (2021/8/29)
• 記事：nWOL version 1.7.55 Released (2021/7/22)
• 記事：nWOL version 1.7.55 をリリースしました (2021/7/22)
• 記事：nWOL version 1.6.74 をリリースしました (2021/1/10)
• 記事：マジックパケットが正しく送信されているか確認する (2021/1/2)
• 記事：WiresharkをWindows10にインストールする方法 (2021/1/2)
• 記事：Windows10の2つのWake on LAN方式と設定方法詳細 (2021/1/2)
• 記事：nWOL version 1.6.40 をリリースしました (2021/1/1)
• 記事：nWOLのDynamic DNS(DDNS)対応について (2021/1/1)
• 記事：Windows10 ネットワークプロファイルの変更方法 (2020/10/31)
• 記事：nWOL version 1.5.31 をリリースしました (2020/8/23)
• 記事：Wake on LANのマジックパケットを送信するWindowsコマンド (2020/8/15)
• 記事：Windows10 PCへのpingが通らない (2020/8/2)
• 記事：nWOL TIPS: 登録ホスト情報を他のユーザに共有する (2020/8/1)
• 記事：nWOL version 1.4.20 をリリースしました (2020/5/6)
• 記事：起動される側のPCのWOL設定：BIOS/UEFIの設定(ASRock) (2020/4/26)
• 記事：起動される側のPCのWOL設定：BIOS/UEFIの設定(ASUS) (2020/4/26)
• 記事：起動される側のPCのWOL設定：BIOS/UEFIの設定(BIOSTAR) (2020/4/26)
• 記事：起動される側のPCのWOL設定：BIOS/UEFIの設定(GIGABYTE) (2020/4/26)
• 記事：起動される側のPCのWOL設定：BIOS/UEFIの設定(MSI) (2020/4/26)
• 記事：Windows PCのWake on LAN設定方法 (2020/4/13)
• 記事：起動される側のPCのWOL設定(1/3)：BIOS/UEFIの設定 (2020/4/8)
• 記事：起動される側のPCのWOL設定(3/3)：その他の設定・確認事項 (2020/4/8)
• 記事：起動される側のPCのWOL設定(2/3)：Windows ネットワークアダプタの設定 (2020/4/8)
• 記事：nWOL TIPS: DHCPでIPアドレスが変わるPCをWOL起動する (2020/2/23)
• 記事：nWOL version 1.3.28 をリリースしました (2020/2/23)
• 記事：nWOL TIPS: LAN内ホスト検索(Scan)が高速で気持ちいい (2020/2/8)
• 記事：nWOL version 1.2.17 をリリースしました (2020/2/2)