Masterファイルを直接編集するため、実行前に必ずMasterファイルをバックアップしてください。

CLIから以下のaddコマンドを実行できます

• add area_location
• add device
• add device_location
• add ip_address
• add ip_address_bulk *Added in Ver 2.6.2
• add l1_link
• add l1_link_bulk
• add l2_segment
• add l2_segment_bulk *Added in Ver 2.6.2
• add portchannel
• add portchannel_bulk *Added in Ver 2.6.2
• add virtual_port
• add virtual_port_bulk *Added in Ver 2.6.2
• add vport_l1if_direct_binding
• add vport_l2_direct_binding
• add waypoint

python [file path]/network_sketcher.py [command] --master [master file path]

• 以下のように[command] 、--master [master file path]　の場所は変更可能
  python [file path]/network_sketcher.py -master [master file path] [command]
  

エリア全体のレイアウト(配置マップ)を更新します。2次元配列でエリアの配置を指定することで、エリアの位置関係を一括で変更できます。新しいエリアも同時に追加可能です。

python [file path]/network_sketcher.py add area_location "[['area_name1','area_name2'],['area_name3','area_name4']]" --master [master file path]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show area_location --master "C:\work[MASTER]test.xlsx"
[['DC1', 'DC2']]

+area_location updated+
＃python .\network_sketcher.py add area_location　"[['DC1','DC2'],['DC3','DC4']]" --master "C:\work[MASTER]test.xlsx"
--- Area layout updated ---
New areas added: ['DC3', 'DC4']
Device added for DC3: DC3_device_
Device added for DC4: DC4_device_
New area layout:
['DC1', 'DC2']
['DC3', 'DC4']

+AFTER+
#python .\network_sketcher.py show area_location --master "C:\work[MASTER]test.xlsx"
[['DC1', 'DC2'], ['DC3', 'DC4']]

[Tips]

• すべての既存エリアは新しいレイアウトに含める必要があります
• 新しいエリアには自動的にデフォルトデバイスが追加されます(通常エリア: [area_name]_device_、waypointエリア: [area_name]から_wp_を除いた名前)
• Waypoint専用エリア(_wp_で終わるエリア名)を横に連続して配置することはできません

既存のデバイスを基準として、新しいデバイスを指定した方向に追加します。デバイスは通常のエリア(非waypointエリア)に追加されます。

python [file path]/network_sketcher.py add device [new_device_name] [reference_device] [direction] --master [master file path]

[direction]の指定:

UP : 基準デバイスの上に追加
DOWN : 基準デバイスの下に追加
LEFT : 基準デバイスの左に追加
RIGHT : 基準デバイスの右に追加
UP_WITH_GRID : 基準デバイスの上に行を追加して配置
DOWN_WITH_GRID : 基準デバイスの下に行を追加して配置
LEFT_WITH_GRID : 基準デバイスの左に列を追加して配置
RIGHT_WITH_GRID : 基準デバイスの右に列を追加して配置

• ex.
  

+BEFORE+
#python .\network_sketcher.py show device_locatoin --master "C:\work[MASTER]test.xlsx"
['tmp', [['sw1', 'sw2']]]

+device added+
＃python .\network_sketcher.py add device 'sw4' 'sw1' RIGHT --master "C:\work[MASTER]test.xlsx"
--- Device added --- sw4 relative to sw1 with direction RIGHT

+AFTER+
#python .\network_sketcher.py show device --master "C:\work[MASTER]test.xlsx"
['tmp', [['sw1', 'sw4', 'sw2']]]

[Tips]

• 追加するデバイス名は既存のデバイス名と重複できません
• waypointエリアに配置されているデバイスを基準にすることはできません

特定のエリア内のデバイス配置を更新します。2次元配列でデバイスのグリッドレイアウトを指定することで、エリア内のデバイス位置を一括で変更できます。既存のデバイスはすべて置き換えられます。

python [file path]/network_sketcher.py add device_location "['area_name',[['device_name1','device2_name'],['device_name3','device_name4']]]" --master [master file path]

ex.

+BEFORE+
#python .\network_sketcher.py show device_location --master "C:\work[MASTER]test.xlsx"
['DC1', [['SW-1', 'SW-2']]]

+device_location updated+
＃python .\network_sketcher.py add device_location "['DC1',[['SW-1','SW-2'],['SW-3','AIR']]]" --master "C:\work[MASTER]test.xlsx"
--- Device location updated for area "DC1" ---
Added devices: ['SW-3']
New device layout (normalized):
['SW-1', 'SW-2']
['SW-3', 'AIR']

+AFTER+
#python .\network_sketcher.py show device_location --master "C:\work[MASTER]test.xlsx"
['DC1', [['SW-1', 'SW-2'], ['SW-3', 'AIR']]]

[Tips]

• デバイスグリッドは自動的に中央揃え・正規化されます
• _AIR_を使用して空のセルを明示的に指定できます
• 新しいデバイスが他のエリアに既に存在する場合はエラーになります
• デバイス配置の変更のみ(追加・削除なし)も可能です

レイヤ３インタフェースにIPアドレスを作成します。１回に１つのIPアドレスが作成できます。繰り返すことで複数のIPアドレスの追加が可能です。

python [file path]/network_sketcher.py add ip_address [device name] [layer3_portname] [ip_address/subnetmask] --master [master file path] 

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', 'Vlan 100', '', '']

+IP Address added+
＃python .\network_sketcher.py add ip_address 'L3SW2' 'Vlan 100' '192.168.100.100/24' --master "C:\work\[MASTER]test.xlsx"
--- IP Address added --- L3SW2,Vlan 100,192.168.100.100/24

+AFTER+
#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', 'Vlan 100', '', '192.168.100.100/24']

このプロセスにより、複数のレイヤー3インターフェースのIPアドレスを一括で作成できます。複数のインターフェースに複数のIPアドレスを1回の操作で追加できるため、個別にadd ip_addressコマンドを実行する場合と比較してパフォーマンスが大幅に向上します。インターフェース上の既存のIPアドレスは保持され、新しいアドレスはマージおよびソートされます。

python [file path]/network_sketcher.py add ip_address_bulk "[['device_name1','port_name1',['ip1','ip2']],['device_name2','port_name2',['ip3']]]" --master [master file path]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l3_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'Vlan 100', '', '']
['L3SW1', 'Vlan 200', '', '']
['L3SW2', 'Vlan 100', '', '']

+ip_address_bulk added+
#python .\network_sketcher.py add ip_address_bulk "[['L3SW1','Vlan 100',['192.168.100.1/24']],['L3SW1','Vlan 200',['192.168.200.1/24','192.168.200.2/24']],['L3SW2','Vlan 100',['192.168.100.2/24']]]" --master "C:\work[MASTER]test.xlsx"
--- Added IP address(es) in bulk ---
L3SW1(Vlan 100) <- 192.168.100.1/24
L3SW1(Vlan 200) <- 192.168.200.1/24, 192.168.200.2/24
L3SW2(Vlan 100) <- 192.168.100.2/24

+AFTER+
#python .\network_sketcher.py show l3_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'Vlan 100', '', '192.168.100.1/24']
['L3SW1', 'Vlan 200', '', '192.168.200.1/24,192.168.200.2/24']
['L3SW2', 'Vlan 100', '', '192.168.100.2/24']

[Tips]

• すべての要素（デバイス名、ポート名、IPアドレス）は、一重引用符または二重引用符で囲む必要があります。
• IPアドレスには、CIDR表記のサブネットマスクを含める必要があります（例：/24）。
• IPアドレス内のスペースは自動的に削除されます（例：'192.168.1.1 / 24' は '192.168.1.1/24' になります）。
• 同じインターフェース上の重複したIPアドレスは自動的にスキップされます。
• IPアドレスはインターフェースごとに自動的に数値順にソートされます。
• 既存のIPアドレスは保持され、新しいアドレスとマージされます。
• 無​​効なIPアドレス形式は、そのエントリに対してのみエラーを生成します。

デバイス間にレイヤ1物理接続を作成します。１回に１つの物理リンクが作成できます。繰り返すことで複数のリンクの追加が可能です。

python [file path]/network_sketcher.py add l1_link [from_device] [to_device] [from_portname] [to_portname] --master [master file path]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l1_link --master "C:\work[MASTER]test.xlsx"
[['SW-1', 'GigabitEthernet 0/0'], ['SW-3', 'GigabitEthernet 0/1']]

+l1_link added+
＃python .\network_sketcher.py add l1_link 'SW-1' 'SW-2' 'GigabitEthernet 0/1' 'GigabitEthernet 0/0' --master "C:\work[MASTER]test.xlsx"
--- Added Layer 1 link --- SW-1 SW-2 GigabitEthernet 0/1 GigabitEthernet 0/0

+AFTER+
#python .\network_sketcher.py show l1_link --master "C:\work[MASTER]test.xlsx"
[['SW-1', 'GigabitEthernet 0/0'], ['SW-3', 'GigabitEthernet 0/1']]
[['SW-1', 'GigabitEthernet 0/1'], ['SW-2', 'GigabitEthernet 0/0']]

[Tips]

• ポート名にスペースが含まれるため、シングルクォート('port 0')で囲む必要があります

複数のレイヤ1物理接続を一括で作成します。配列形式で複数のリンク定義を指定することで、効率的に複数のリンクを追加できます。

python [file path]/network_sketcher.py add l1_link_bulk "[['from_device1','to_device1','from_port1','to_port1'],['from_device2','to_device2','from_port2','to_port2']]" --master [master file path]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l1_link --master "C:\work[MASTER]test.xlsx"
[['SW-1', 'GigabitEthernet 0/0'], ['SW-3', 'GigabitEthernet 0/1']]

+l1_link_bulk added+
＃python .\network_sketcher.py add l1_link_bulk "[['SW-1','SW-2','GigabitEthernet 0/1','GigabitEthernet 0/0'],['SW-2','SW-3','GigabitEthernet 0/1','GigabitEthernet 0/2']]" --master "C:\work[MASTER]test.xlsx"
--- Added 2 Layer 1 link(s) in bulk ---
SW-1(GigabitEthernet 0/1) ↔ SW-2(GigabitEthernet 0/0)
SW-2(GigabitEthernet 0/1) ↔ SW-3(GigabitEthernet 0/2)
Affected devices: ['SW-1', 'SW-2', 'SW-3']

+AFTER+
#python .\network_sketcher.py show l1_link --master "C:\work[MASTER]test.xlsx"
[['SW-1', 'GigabitEthernet 0/0'], ['SW-3', 'GigabitEthernet 0/1']]
[['SW-1', 'GigabitEthernet 0/1'], ['SW-2', 'GigabitEthernet 0/0']]
[['SW-2', 'GigabitEthernet 0/1'], ['SW-3', 'GigabitEthernet 0/2']]

[Tips]

• すべての要素(デバイス名、ポート名)はシングルクォートまたはダブルクォートで囲む必要があります
• バッチ内で同じポートを複数回使用するとエラーになります
• 既存のリンクで使用されているポートは使用できません

インタフェースにVLAN等のレイヤ２セグメントを作成します。１回に１つのレイヤ２セグメントが作成できます。複数のレイヤ２セグメントの作成が可能です。

python [file path]/network_sketcher.py add l2_segment [device name] [layer2_portname] [l2segment_name]　--master [master file path] 

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', 'GigabitEthernet 0/0', '', 'Vlan100,Vlan200,Vlan300', '']

+l2_segment added+
＃python .\network_sketcher.py add l2_segment 'L3SW2' 'GigabitEthernet 0/0' 'addvlan999' --master "C:\work\[MASTER]test.xlsx"
--- l2 Segment added --- L3SW2,GigabitEthernet 0/0,addvlan999

+AFTER+
#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', 'GigabitEthernet 0/0', '', 'Vlan100,Vlan200,Vlan300,addvlan999', '']

この機能を使用すると、複数のインターフェースにレイヤ2セグメント（VLANなど）を一括で作成できます。複数のL2セグメントを1回の操作で複数のインターフェースに追加できるため、add l2_segmentコマンドを個別に実行する場合と比較してパフォーマンスが大幅に向上します。インターフェース上の既存のL2セグメントは保持され、新しいセグメントはマージおよびソートされます。

python [file path]/network_sketcher.py add l2_segment_bulk "[['device_name1','port_name1',['vlan1','vlan2']],['device_name2','port_name2',['vlan3']]]" --master [master file path]

複数デバイス指定 (Option A): 先頭要素にデバイス名のリストを指定すると、複数デバイスに同じセグメントを一括適用できます。

[["device_name1","device_name2"],"port_name",["vlan1","vlan2"]]

ポート名リスト指定 (Option B): 第2要素にポート名のリストを指定すると、複数のポートに同じセグメントを一括適用できます。

[["device_name",["port1","port2"],["vlan1","vlan2"]]]

組み合わせ (Option A + B): 両方を組み合わせることができます。

[[["device_name1","device_name2"],["port1","port2"],["vlan1","vlan2"]]]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', 'Vlan100', '']
['L3SW1', 'GigabitEthernet 0/1', '', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '', '']

+l2_segment_bulk added+
#python .\network_sketcher.py add l2_segment_bulk "[['L3SW1','GigabitEthernet 0/0',['Vlan200','Vlan300']],['L3SW1','GigabitEthernet 0/1',['Vlan100','Vlan200']],['L3SW2','GigabitEthernet 0/0',['Vlan100','Vlan200','Vlan300']]]" --master "C:\work[MASTER]test.xlsx"

--- Added L2 segment(s) in bulk ---
L3SW1(GigabitEthernet 0/0) <- Vlan200, Vlan300
Final: Vlan100, Vlan200, Vlan300
L3SW1(GigabitEthernet 0/1) <- Vlan100, Vlan200
Final: Vlan100, Vlan200
L3SW2(GigabitEthernet 0/0) <- Vlan100, Vlan200, Vlan300
Final: Vlan100, Vlan200, Vlan300

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', 'Vlan100,Vlan200,Vlan300', '']
['L3SW1', 'GigabitEthernet 0/1', '', 'Vlan100,Vlan200', '']
['L3SW2', 'GigabitEthernet 0/0', '', 'Vlan100,Vlan200,Vlan300', '']

追加例 (Ver 3.0.1)

例 A: 複数デバイス指定 (Option A) - 複数デバイスに同じVLANを適用
#python .\network_sketcher.py add l2_segment_bulk "[[['Access-Stack1','Access-Stack2','Access-Stack3'],'Port-channel 1',['Vlan10','Vlan20','Vlan100','Vlan200']]]" --master "C:\work\[MASTER]test.xlsx"

例 B: ポート名リスト (Option B) - 複数ポートに同じVLANを適用
#python .\network_sketcher.py add l2_segment_bulk "[['Access-Stack1',['GigabitEthernet 1/0/47','GigabitEthernet 2/0/47'],['Vlan10','Vlan20']]]" --master "C:\work\[MASTER]test.xlsx"

例 C: 組み合わせ (Option A + B)
#python .\network_sketcher.py add l2_segment_bulk "[[['Access-Stack1','Access-Stack2'],['GigabitEthernet 1/0/47','GigabitEthernet 2/0/47'],['Vlan10','Vlan20']]]" --master "C:\work\[MASTER]test.xlsx"

[Tips]

• すべての要素（デバイス名、ポート名、セグメント名）は、一重引用符または二重引用符で囲む必要があります。
• セグメント名に含まれるスペースは自動的に削除されます（例：'Vlan 100' は 'Vlan100' になります）。
• 同じインターフェース上の重複セグメントは自動的にスキップされます。
• セグメントは自動的にソートされます（VLAN 番号は数値順にソートされます）。
• 既存の L2 セグメントは保持され、新しいセグメントとマージされます。
• vport_l2_direct_binding が設定されているインターフェースでは使用できません。
• 物理ポート（GigabitEthernet など）と仮想ポート（Vlan、Port-channel など）の両方がサポートされています。
• 先頭要素にデバイス名のリスト(例: ["device1","device2"]) を指定すると (Option A) 複数デバイスに同じセグメントを一括適用できます
• 第2要素にポート名のリスト(例: ["port1","port2"]) を指定すると (Option B) 複数ポートに同じセグメントを一括適用できます
• [重要] デバイスリストとポートリストを組み合わせる (Option A + B) 場合、すべてのデバイスに指定したポートがすべて存在する必要があります

レイヤ1インタフェースにポートチャネル(LAG)を作成します。

python [file path]/network_sketcher.py add portchannel [device name] [layer1_portname] [portchannel_name]　--master [master file path] 

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '', '']
['L3SW1', 'GigabitEthernet 0/1', '', '', '']

#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '']
['L3SW1', 'GigabitEthernet 0/1', '', '']

+portchannel added+
＃python .\network_sketcher.py add portchannel 'L3SW1' 'GigabitEthernet 0/0' 'PortChannel 1' --master "C:\work\[MASTER]test.xlsx"
--- portchannel added --- L3SW1,GigabitEthernet 0/0,PortChannel 1
＃python .\network_sketcher.py add portchannel 'L3SW1' 'GigabitEthernet 0/1' 'PortChannel 1' --master "C:\work\[MASTER]test.xlsx"
--- portchannel added --- L3SW1,GigabitEthernet 0/1,PortChannel 1

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', 'PortChannel 1', '', '']
['L3SW1', 'GigabitEthernet 0/1', 'PortChannel 1', '', '']

#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW1', 'PortChannel 1', '', '']

この機能を使用すると、複数のレイヤ1インターフェース上にポートチャネル（LAG）を一括で作成できます。複数の物理インターフェースを複数のデバイスにまたがるポートチャネルに1回の操作で割り当てることができるため、個別のadd portchannelコマンドを実行する場合と比較してパフォーマンスが大幅に向上します。

python [file path]/network_sketcher.py add portchannel_bulk "[['device_name1',['port1','port2'],'portchannel_name1'],['device_name2',['port3','port4'],'portchannel_name2']]" --master [master file path]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '', '']
['L3SW1', 'GigabitEthernet 0/1', '', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '', '']
['L3SW2', 'GigabitEthernet 0/1', '', '', '']

#python .\network_sketcher.py show l3_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '']
['L3SW1', 'GigabitEthernet 0/1', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '']
['L3SW2', 'GigabitEthernet 0/1', '', '']

+portchannel_bulk added+
#python .\network_sketcher.py add portchannel_bulk "[['L3SW1',['GigabitEthernet 0/0','GigabitEthernet 0/1'],'Port-channel 1'],['L3SW2',['GigabitEthernet 0/0','GigabitEthernet 0/1'],'Port-channel 1']]" --master "C:\work[MASTER]test.xlsx"
--- Added port-channel(s) in bulk ---
L3SW1: GigabitEthernet 0/0, GigabitEthernet 0/1 -> Port-channel 1
L3SW2: GigabitEthernet 0/0, GigabitEthernet 0/1 -> Port-channel 1

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', 'Port-channel 1', '', '']
['L3SW1', 'GigabitEthernet 0/1', 'Port-channel 1', '', '']
['L3SW2', 'GigabitEthernet 0/0', 'Port-channel 1', '', '']
['L3SW2', 'GigabitEthernet 0/1', 'Port-channel 1', '', '']

#python .\network_sketcher.py show l3_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'Port-channel 1', '', '']
['L3SW2', 'Port-channel 1', '', '']

[Tips]

• すべての要素（デバイス名、ポート名、ポートチャネル名）は、一重引用符または二重引用符で囲む必要があります。
• ポートチャネル名は有効なインターフェース名である必要があります（例：'Port-channel 1'、'PortChannel 1'）。
• 1つのエントリで、複数の物理インターフェースを同じポートチャネルに割り当てることができます。
• 物理インターフェースがすでに別のポートチャネルに割り当てられている場合は、エラーが発生します。
• ポートチャネルインターフェースは、L3インターフェーステーブルに自動的に作成されます。
• インターフェース名に含まれるスペースは正規化されます（複数のスペースは単一のスペースに変換されます）。

VLAN インターフェイス (SVI) などのレイヤー 3 インターフェイスを作成します。virtual port作成後は、ループバックアドレスの状態となるため、VLANなどのレイヤ２セグメントと接続する場合は、追加でadd l2_segmentコマンドを実施し、作成したvirtual portとl2_segmentを接続してください。

python [file path]/network_sketcher.py add virtual_port [device name] [virtual_portname] --master [master file path] 

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', '', 'Vlan 300', 'Vlan300', '']

#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', 'Vlan 300', '', '']

+virtual_port added+
＃python .\network_sketcher.py add virtual_port 'L3SW2' 'addvlan 999' --master "C:\work\[MASTER]test.xlsx"
--- Virtual Port added --- L3SW2,addvlan 999

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', '', 'addvlan 999', '', '']
['L3SW2', '', 'Vlan 100', 'Vlan100', '']

#python .\network_sketcher.py show l3_interface --master "C:\work\[MASTER]test.xlsx"
['L3SW2', 'Vlan 300', '', '']
['L3SW2', 'addvlan 999', '', '']

この機能を使用すると、複数のデバイスにレイヤー3仮想インターフェース（VLANインターフェース/SVI、ループバックインターフェースなど）を一括で作成できます。複数のデバイスに複数の仮想ポートを1回の操作で追加できるため、個別にadd virtual_portコマンドを実行する場合と比較してパフォーマンスが大幅に向上します。

python [file path]/network_sketcher.py add virtual_port_bulk "[['device_name1',['vport1','vport2']],['device_name2',['vport3','vport4']]]" --master [master file path]

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '', '']

#python .\network_sketcher.py show l3_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '']

+virtual_port_bulk added+
#python .\network_sketcher.py add virtual_port_bulk "[['L3SW1',['Vlan 100','Vlan 200','Loopback 0']],['L3SW2',['Vlan 100','Vlan 200']]]" --master "C:\work[MASTER]test.xlsx"
--- Added virtual port(s) in bulk ---
L3SW1 <- Vlan 100, Vlan 200, Loopback 0
L3SW2 <- Vlan 100, Vlan 200

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '', '']
['L3SW1', '', 'Loopback 0', '', '']
['L3SW1', '', 'Vlan 100', '', '']
['L3SW1', '', 'Vlan 200', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '', '']
['L3SW2', '', 'Vlan 100', '', '']
['L3SW2', '', 'Vlan 200', '', '']

#python .\network_sketcher.py show l3_interface --master "C:\work[MASTER]test.xlsx"
['L3SW1', 'GigabitEthernet 0/0', '', '']
['L3SW1', 'Loopback 0', '', '']
['L3SW1', 'Vlan 100', '', '']
['L3SW1', 'Vlan 200', '', '']
['L3SW2', 'GigabitEthernet 0/0', '', '']
['L3SW2', 'Vlan 100', '', '']
['L3SW2', 'Vlan 200', '', '']

[Tips]

• すべての要素（デバイス名、仮想ポート名）は、一重引用符または二重引用符で囲む必要があります。
• 仮想ポート名は有効なインターフェース名である必要があります（例：'Vlan 100'、'Loopback 0'、'Tunnel 1'）。
• 仮想ポートの作成後、仮想ポートはループバック状態になります。L2セグメントに接続するには、add l2_segment または add l2_segment_bulk を使用します。
• 同一デバイス上の重複する仮想ポート名は、警告とともに自動的にスキップされます。
• 仮想ポート名が既存のL1インターフェース名と競合する場合は、エラーが発生します。
• 仮想ポートはインターフェース値によって自動的にソートされます（例：Vlan 100 は Vlan 200 より前）。
• インターフェース名内のスペースは正規化されます（複数のスペースは単一のスペースに変換されます）。

レイヤ1インタフェースと直接接続するVirutal portを追加します。例えば、ルータでサブインタフェースを作成し、サブインタフェース毎にdot1qタギングを構成する場合に使用します。１つのレイヤ1インタフェースで複数のVirtual portを接続させる構成も可能です。この設定のみではサブインタフェースを作成した状態であるため、レイヤ２を送受信するには、この設定にadd vport_l2_direct_bindingを追加して作成したVirutal portにVLAN等のレイヤ２要素を追加する必要があります。

python [file path]/network_sketcher.py add vport_l1if_direct_binding [device name] [Layer1 port] [vport_name_direct_binding] --master [master file path] 

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['Catalyst 3560', 'GigabitEthernet 0/0', '', '', '']

+vport_l1if_direct_binding added+
＃python .\network_sketcher.py add vport_l1if_direct_binding "Catalyst 3560" "GigabitEthernet 0/0" "GigabitEthernet 0/0.100" --master "C:\work\[MASTER]test.xlsx"
--- vport_l1if_direct_binding added --- Catalyst 3560,GigabitEthernet 0/0,GigabitEthernet 0/0.100

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['Catalyst 3560', 'GigabitEthernet 0/0', 'GigabitEthernet 0/0.100', '', '']

Virtualポートで直接VLANのようなレイヤ２を送受信させます。通常は、Virtualポートはl2_segmentと接続して、そのl2_segmentとレイヤ１インタフェースと接続することで、レイヤ１インタフェースとVirtualポートを接続しますが、このコマンドは、直接Virtualポートとレイヤ１インタフェースとを接続し、VLAN(l2_segment)のようなレイヤ２の要素を送受信させます。例えば、ルータでサブインタフェースを作成し、サブインタフェース毎にdot1qタギングを構成する場合に使用します。１つのVirtualポートで複数のVLANのようなレイヤ２を送受信させる構成も可能です。なお、同じVirtual portでl2_segmentとvport_l2_direct_bindingを同時に登録することはできません。また、事前にVirutal portの設定が必要となりますが、add vport_l1if_direct_bindingコマンドで追加してください。add virtual_portコマンドで作成したVirtual portはadd vport_l2_direct_bindingコマンドで使用しません。

python [file path]/network_sketcher.py add vport_l2_direct_binding [device name] [virtual port] [l2_name_direct_binding] --master [master file path] 

• ex.
  

+BEFORE+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['Catalyst 3560', 'GigabitEthernet 0/0', 'GigabitEthernet 0/0.100', '', '']

+vport_l2_direct_bindingadded+
＃python .\network_sketcher.py add vport_l2_direct_binding "Catalyst 3560" "GigabitEthernet 0/0.100" vlan100 --master "C:\work\[MASTER]test.xlsx"
--- vport_l2_direct_binding added --- Catalyst 3560,GigabitEthernet 0/0.100,vlan100

+AFTER+
#python .\network_sketcher.py show l2_interface --master "C:\work\[MASTER]test.xlsx"
['Catalyst 3560', 'GigabitEthernet 0/0', 'GigabitEthernet 0/0.100', '', 'vlan100']

既存のwaypointを基準として、新しいwaypointを指定した方向に追加します。Waypointはwaypoint専用エリア(_wp_で終わるエリア名)に追加されます。

python [file path]/network_sketcher.py add waypoint [new_waypoint_name] [reference_waypoint] [direction] --master [master file path]

[direction]の指定:

UP : 基準waypointの上に追加
DOWN : 基準waypointの下に追加
LEFT : 基準waypointの左に追加
RIGHT : 基準waypointの右に追加

• ex.
  

+BEFORE+
#python .\network_sketcher.py show waypoint_locatoin --master "C:\work[MASTER]test.xlsx"
['WAN-1_wp_', [['WAN-1']]]

+waypoint added+
＃python .\network_sketcher.py add waypoint 'WAN-2' 'WAN-1' 'RIGHT' --master "C:\work[MASTER]test.xlsx"
--- Waypoint added --- WAN-2 relative to WAN-1 with direction RIGHT

+AFTER+
#python .\network_sketcher.py show waypoint_locatoin --master "C:\work[MASTER]test.xlsx"
['WAN-1_wp_', [['WAN-1', 'WAN-2']]]

[Tips]

• Waypointは必ずwaypoint専用エリア(_wp_で終わるエリア名)内に配置されます
• 基準デバイスがwaypoint専用エリアに存在しない場合はエラーになります
• X軸に隣接するエリアに通常エリアが存在する場合、UP/DOWNのみ使用可能です
• X軸に隣接するエリアがすべてwaypointエリアまたは空の場合、LEFT/RIGHTのみ使用可能です