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

nWOLcの概要

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

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

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

nWOLc: nWOL console command   (Version 1.7.75)

-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 WOL-capable hosts
-r "regex"             Send magic packet to regex-matched WOL-capable hosts
-m mac [ip [mask]]     Send magic packet
-p hostname            Check status of a host(or IP) (retcode=0 when online)
-w hostname [waitsec]  Wait for a host(or IP) to come online (retcode=0 when online)
-t sec                 Set ping timeout in seconds for -p or -w (default=1)
-u port                Specify destination UDP port number of Magic Packet
-i                     Ignore case when -l, -f or -r
-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... ：ホスト名を指定してマジックパケットを送信する

ホスト名を指定してマジックパケットを送信します。WOLが許可されていないホストは除外されます。

nwolc -h Server1 "File Server"

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

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

正規表現にマッチするホスト全てにマジックパケットを送信します。WOLが許可されていないホストは除外されます。

nwolc -r ^[0-9]

nwolc -r PC$ -i

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

-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 を送信して、ホストの起動状態を調べます。

nwolc -p Server1

nwolc -p 192.168.1.6

nwolc -p mypc.mydomain.com

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を指定しない場合、ホストが起動するまでコマンドが終了しませんのでご注意ください。

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 mypc.mydomain.com 60

nwolc -h Server1 -w Server1 60

nwolc -a -w Server1

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

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

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

nwolc -p Server1 -t 3

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

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

-a, -h, -r, -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 で、正規表現の処理を行う際に、大文字小文字を区別しない設定にします。

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

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

ユーザ名を指定した場合、設定ファイルは C:\Users\<ユーザ名>\AppData\Roaming\nWOL\nWOL.conf となります。

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

nwolc -c "c:\Users\User Name\AppData\
Roaming\nWOL\nWOL.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 いずれかと -w が同時に指定された場合、 マジックパケット送信処理でエラーが表示されていても、-w の戻り値が返されます。

-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 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)