-
Notifications
You must be signed in to change notification settings - Fork 16
8‐5. Export Commands_jp
CLIから以下のexportコマンドを実行できます
export ai_context_file
export device_file
export l1_diagram *Added in Ver 2.6.3
export l2_diagram *Added in Ver 2.6.3
export l3_diagram *Added in Ver 2.6.3
export master_file_backup
export master_file_nodata
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]
大規模言語モデル(LLM)へのアップロード用のコンテキストファイルを生成します。ネットワーク構成情報をテキスト形式で出力し、AI分析やドキュメント生成に活用できます。
python [file path]/network_sketcher.py export ai_context_file --master [master file path] --accept-security-risk
オプション:
--accept-security-risk : セキュリティリスクを理解し、エクスポートを実行することを明示的に承認します。このオプションを付けない場合は、セキュリティリスク同意のYES/NOの入力画面が表示されます。
- ex.
+Export ai_context_file+
#python .\network_sketcher.py export ai_context_file --master "C:\work[MASTER]test.xlsx" --accept-security-risk
--- export_ai_context_file ---
** Exporting xx/xx
--- AI Context file created successfully ---
AI Context file: C:\work[AI_Context]test.txt
Size: 47,201 bytes
[Tips]
- 出力ファイル名は自動的に[AI_Context]master_file_name.txtとなります
[DEVICE]ファイルをエクスポートします。
python [file path]/network_sketcher.py export device_file --master [master file path]- ex.
+Export device_file+
#python .\network_sketcher.py export device_file 'SW-1' --master "C:\work[MASTER]test.xlsx"
--- Device file create ---
--- Device file created successfully ---
[Tips]
- 出力ファイル名は自動的に[DEVICE]master_file_name.xlsxとなります
L1(物理層)ネットワーク構成図をPowerPointファイルとしてエクスポートします。--typeオプションで構成図の種類を選択できます。
python [file path]/network_sketcher.py export l1_diagram --master [master file path] --type [diagram type]オプション:
--type : 構成図の種類を指定します。指定可能な値は以下の通りです。省略した場合は all_areas_tag がデフォルトで使用されます。
| 値 | 説明 |
|---|---|
| all_areas | 全エリア構成図 |
| all_areas_tag | 全エリア構成図(IFタグ付き)(デフォルト) |
| per_area | エリア別構成図 |
| per_area_tag | エリア別構成図(IFタグ付き) |
- ex.
+Export l1_diagram(全エリア・IFタグ付き)+
#python .\network_sketcher.py export l1_diagram --master "C:\work[MASTER]test.xlsx"
--- L1 Diagram (all_areas_tag) created successfully ---
File: C:\work[L1_DIAGRAM]AllAreasTag_test.pptx
+Export l1_diagram(エリア別)+
#python .\network_sketcher.py export l1_diagram --master "C:\work[MASTER]test.xlsx" --type per_area
--- L1 Diagram (per_area) created successfully ---
File: C:\work[L1_DIAGRAM]PerArea_test.pptx
[Tips]
- 出力ファイル名は構成図の種類に応じて自動的に生成されます:
- all_areas → [L1_DIAGRAM]AllAreas_master_file_name.pptx
- all_areas_tag → [L1_DIAGRAM]AllAreasTag_master_file_name.pptx
- per_area → [L1_DIAGRAM]PerArea_master_file_name.pptx
- per_area_tag → [L1_DIAGRAM]PerAreaTag_master_file_name.pptx
-
all_areasおよびall_areas_tagの場合、サマリーページが自動的に含まれます - 出力ファイルはMasterファイルと同じディレクトリに作成されます
指定したエリアのL2(データリンク層)ネットワーク構成図をPowerPointファイルとしてエクスポートします。--areaオプションで対象エリアを選択できます。
python [file path]/network_sketcher.py export l2_diagram --master [master file path] --area [area name]オプション:
--area : 対象エリア名を指定します。省略した場合はMasterファイル内の最初のエリアがデフォルトで使用されます。
- ex.
+Export l2_diagram+
#python .\network_sketcher.py export l2_diagram --master "C:\work[MASTER]test.xlsx" --area Office
--- L2 Diagram (area: Office) created successfully ---
File: C:\work[L2_DIAGRAM]Office_test.pptx
[Tips]
- 出力ファイル名は自動的に[L2_DIAGRAM]area_name_master_file_name.pptxとなります
- 指定できるのは通常のエリアのみです(WAN接続点などのウェイポイントエリアは対象外です)
- 指定したエリアが存在しない場合、エラーとともに利用可能なエリアの一覧が表示されます
- 出力ファイルはMasterファイルと同じディレクトリに作成されます
L3(ネットワーク層)ネットワーク構成図をPowerPointファイルとしてエクスポートします。--typeオプションで構成図の種類を選択できます。
python [file path]/network_sketcher.py export l3_diagram --master [master file path] --type [diagram type]オプション:
--type : 構成図の種類を指定します。指定可能な値は以下の通りです。省略した場合は all_areas がデフォルトで使用されます。
| 値 | 説明 |
|---|---|
| all_areas | 全エリア構成図(デフォルト) |
| per_area | エリア別構成図 |
- ex.
+Export l3_diagram(全エリア)+
#python .\network_sketcher.py export l3_diagram --master "C:\work[MASTER]test.xlsx"
--- L3 Diagram (all_areas) created successfully ---
File: C:\work[L3_DIAGRAM]AllAreas_test.pptx
+Export l3_diagram(エリア別)+
#python .\network_sketcher.py export l3_diagram --master "C:\work[MASTER]test.xlsx" --type per_area
--- L3 Diagram (per_area) created successfully ---
File: C:\work[L3_DIAGRAM]PerArea_test.pptx
[Tips]
- 出力ファイル名は構成図の種類に応じて自動的に生成されます:
- all_areas → [L3_DIAGRAM]AllAreas_master_file_name.pptx
- per_area → [L3_DIAGRAM]PerArea_master_file_name.pptx
- 出力ファイルはMasterファイルと同じディレクトリに作成されます
現在のMasterファイルのバックアップを作成します。タイムスタンプ付きでバックアップファイルが生成されます。
python [file path]/network_sketcher.py export master_file_backup --master [master file path]- ex.
+Export master_file_backup+
#python .\network_sketcher.py export master_file_backup --master "C:\work[MASTER]test.xlsx"
--- Backup Master file --- C:\work[MASTER]test_20251208145631.xlsx
--- Master file backup created successfully ---
Original file: C:\work[MASTER]test.xlsx
Size: 7,200 bytes
Backup file: C:\work[MASTER]test_20251208145631.xlsx
Size: 7,200 bytes
Verification: File sizes match ✓
[Tips]
- バックアップファイル名は自動的にmaster_file_name_YYYYMMDDHHMMSS.xlsxとなります
- 変更を行う前のバックアップ作成を推奨します
- バックアップファイルは元のMasterファイルと同じディレクトリに作成されます
データが入っていない空のMasterファイルテンプレートを作成します。新規ネットワーク構成を一から作成する際のベースファイルとして利用できます。
python [file path]/network_sketcher.py export master_file_nodata --master [master file path]- ex.
+Export master_file_nodata+
#python .\network_sketcher.py export master_file_nodata --master "C:\work[MASTER]test.xlsx"
--- Empty master file created successfully ---
File: C:\work[MASTER]test.xlsx
Size: 7,145 bytes
Sheets: Master_Data, Master_Data_L2, Master_Data_L3
The file contains no areas or devices.
[Tips]
- --master で指定したファイルが既に存在する場合はエラーとなり処理を終了します
- Yusuke Ogawa - Security Architect, Cisco | CCIE#17583
SPDX-License-Identifier: Apache-2.0
Copyright 2023 Cisco Systems, Inc. and its affiliates
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.