1、命令行使用
1.1、命令行语法
[prefix] [path] command [uparam] [param=[value]] .. [param=[value]]
[prefix] - 前缀,以"."或"/"开头(字符用来表达路径除外),可选
[path] - 命令菜单层相对路径,可选
cmdmand - 命令,必选
[uparam] - 非注明参数(纯值),可选
[param=[value]] - 注明参数名称=值,可选
":"
非注明参数写法
[admin@MikroTik] >:put "cmdschool.org" cmdschool.org
[admin@MikroTik] >:put message="cmdschool.org" cmdschool.org
[admin@MikroTik] >/ip address print # ADDRESS NETWORK INTERFACE 0 192.168.1.1/24 192.168.1.0 bridge01 1 D 119.128.4.27/32 119.128.4.1 ChinaNet
";"与回车标志命令行结束并执行,当命令包含在"{}" or "[]" or "()"中可以不需要结束符。
";"使用演示:
[admin@MikroTik] >:put "cmdschool"; :put ".org"; cmdschool .org
[admin@MikroTik] >:put "cmdschool"; cmdschool [admin@MikroTik] >:put ".org"; .org
[admin@MikroTik] >:put "cmdschool" cmdschool [admin@MikroTik] >:put ".org" .org
[admin@MikroTik] >{:put "cmdschool.org"} cmdschool.org
[admin@MikroTik] >[ :put "cmdschool.org" ] cmdschool.org
[admin@MikroTik] >put (1+4) 5
以"#"开头的行,整行命令被忽略处理(不执行)
[admin@MikroTik] >#:put cmdschool.org [admin@MikroTik] >
以"\"结尾的行与下一行组成一个逻辑行(相当于一个物理行),当一行命令处理。
[admin@MikroTik] >:put "cmdschool.org" cmdschool.org [admin@MikroTik] >:put "cmdschool\ .org" cmdschool.org
Opearator | Syntax | Description | Example |
"/" | 到达跟 | ||
".." | 返回上一级目录 | ||
? | 帮助命令 | ||
global | :global <var> [<value>] | 定义全局变量 | |
local | :local <var> [<value>] | 定义本地变量 | |
beep | :beep <freq> <length> | 内置扬声器产生蜂鸣 | |
delay | :delay <time> | 暂停一段时间 | |
put | :put <expression> | 标准输出 | |
len | :len <expression> | 返回字符串长度 | |
typeof | :typeof <var> | 返回变量的数据类型 | |
pick | :pick <var
<start> <end> |
返回数组元素或子字符串的范围 | |
log | :log <topic> | 返回执行命令所用的时间间隔 | |
time | :time <expression> | ||
set | :set <var> [<value>] | 赋值已经声明的变量 | |
find | :find <arg> <arg> <start> | 返回子字符串或数组元素的位置 | |
environment | :environment print <start> | 输出已初始化全局变量信息 | |
terminal | 控制台相关命令 | ||
error | :error <output> | 终止脚本运行并产生标准错误输出 | |
parse | :parse <expression> | 输出查询的命令解析 | |
resolve | :resolve <arg> | DNS解析命令(域名翻译成IP地址) | |
toarray | :toarray <var> | 将变量转换为数组类型 | |
tobool | :tobool <var> | 将变量转换为布尔类型 | |
toid | :toid <var> | 将变量转换为internal id类型 | |
toip | :toip <var> | 将变量转换为IP地址 | |
toip6 | :toip6 <var> | 将变量转换为IPv6地址 | |
tonum | :tonum <var> | 将变量转换为整型 | |
totime | :totime <var> | 将变量转换为time型 |
"/"命令
[admin@MikroTik] >/ip address [admin@MikroTik] /ip address> [admin@MikroTik] /ip address>/ [admin@MikroTik] >
[admin@MikroTik] >/ip address [admin@MikroTik] /ip address> [admin@MikroTik] /ip address>.. [admin@MikroTik] /ip>
[admin@MikroTik] > [admin@MikroTik] /ip address>? IP addresses are given to router to access it remotely and to specify it as a gateway for other hosts/routers. .. -- go up to ip add -- Create a new item comment -- Set comment for items disable -- Disable items edit -- enable -- Enable items export -- Print or save an export script that can be used to restore configuration find -- Find items by value get -- Gets value of item's property print -- Print values of item properties remove -- Remove item set -- Change item properties [admin@MikroTik] /ip address>
[admin@MikroTik] >:beep length=2s [admin@MikroTik] >:beep length=2s frequency=500 [admin@MikroTik] >
[admin@MikroTik] >:delay 2; [admin@MikroTik] >
[admin@MikroTik] >:put "cmdschool.org"; cmdschool.org [admin@MikroTik] >
[admin@MikroTik] >:put [:len "cmdschool.org"]; 13 [admin@MikroTik] >
[admin@MikroTik] >:put [:typeof 4]; num [admin@MikroTik] >:put [:typeof a]; str
[admin@MikroTik] >:put [:pick "cmdschool.org" 0 9]; cmdschool [admin@MikroTik] >
[admin@MikroTik] >:log print [admin@MikroTik] >:log info message="cmdschool"; [admin@MikroTik] >:log print 17:39:24 script,info cmdschool [admin@MikroTik] >
[admin@MikroTik] >:put [:time [:resolve www.baidu.com];]; 00:00:00.002257 [admin@MikroTik] >
[admin@MikroTik] >:put [:find "cmdschool.org" "."]; 9 [admin@MikroTik] >
[admin@MikroTik] >:global cmdschool "cmdschool.org"; [admin@MikroTik] >:environment print; cmdschool="cmdschool.org" [admin@MikroTik] >
[admin@MikroTik] >{ :put "start"; :error message="error x01"; :put "end"; } start error x01 [admin@MikroTik] >
[admin@MikroTik] >:put [:parse value=resolve] (eval /resolve) [admin@MikroTik] >:put [:parse value=put] (eval /put) [admin@MikroTik] >:put [:parse value=cmdschool.org] (<%% bad command name cmdschool.org (line 1 column 1) cmdschool.org) [admin@MikroTik] >
[admin@MikroTik] >:put [:resolve www.baidu.com;] 180.97.33.108 [admin@MikroTik] >
2.1、转义字符:
Opearator | Description | Example |
"\" | 转义字符 |
特殊字符"\":
[admin@MikroTik] >:put "\""; "
下面的转义序列可以用于在字符串内定义特殊的字符。
\" 插入双引号
[admin@MikroTik] >:put "\""; "
[admin@MikroTik] >:put "\\"; \
[admin@MikroTik] >:put "cmdschool.org"; cmdschool.org [admin@MikroTik] >:put "cmdschool\n.org"; cmdschool .org
[admin@MikroTik] >:put "cmdschool\t.org"; cmdschool .org
[admin@MikroTik] >:put "\$"; $
[admin@MikroTik] >:put "\?"; ?
[admin@MikroTik] >:put "cmdschool\_.org"; cmdschool .org
[admin@MikroTik] >:put "cmdschool\_.org"; cmdschool .org
[admin@MikroTik] >:put "cmdschool.\borg"; cmdschoolorg
[admin@MikroTik] >:put "cmdschool\f.org"; .org [dgadmin@MikroTik] /ip address>
[admin@MikroTik] >:put "cmdschool\v.org"; cmdschool .org
\xx 从16进制数值输出字符,十六进制数值应该用大写字母对应的。
3、运算符
3.1、算术运算符
Opearator | Description | Example |
"+" | binary addition | :put (3+4); |
"-" | binary subtraction | :put (1-6); |
"*" | binary multiplication | :put (4*5); |
"/" | binary division | :put (10/2); |
"-" | unary negation | {:local a 1; :put (-a)} |
"+"运算符:
[admin@MikroTik] >:put (3+4); 7
[admin@MikroTik] >:put (1-6); -5
[admin@MikroTik] >:put (4*5); 20
[admin@MikroTik] >:put (10/2); 5
[admin@MikroTik] >{:local a 1; :put (-a)} -1
Opearator | Description | Example |
"<" | 小于 | :put (3<4); |
">" | 大于 | :put (3>4); |
"=" | 等于 | :put (2=2); |
"<=" | 小于等于 | |
">=" | 大于等于 | |
"!=" | 不等于 |
"<"运算符:
[admin@MikroTik] >:put (3<4); true
1)example1
[admin@MikroTik] >:put (3>4); false
[admin@MikroTik] >:put (2>2); true
Opearator | Description | Example |
"!","not" | logical NOT | :put (!true); |
"&&","and" | logical AND | :put (true&&true); |
"||","or" | logical OR | :put (true||false); |
"in" | :put (1.1.1.1/32 in 10.0.0/8); |
"!"运算符:
[admin@MikroTik] >:put (!true); false
[admin@MikroTik] >:put (true&&true); true
[admin@MikroTik] >:put (true||false); true
[admin@MikroTik] >:put (1.1.1.1/32 in 10.0.0/8); false
Opearator | Description | Example |
"~" | 比特位倒置 | :put (~(0.0.0.0))
:put (~(255.255.255.255)) |
"|" | 比特位或:执行逻辑的或运算。在每一对对应的比特位,如果连个比特位至少有一个值为1,则结果为
“1”否则结果为“0”。 |
:put ((0.0.0.0) | (0.0.0.0))
:put ((0.0.0.1) | (0.0.0.0)) :put ((0.0.1.0) | (0.0.0.1)) |
"^" | 比特位抑或:如果一对比特位的值不相等结果为1,比特位的值相等结果为0。 | :put ((0.0.0.0) ^ (0.0.0.0))
:put ((0.0.0.1) ^ (0.0.0.1)) :put ((0.0.0.0) ^ (0.0.0.1)) |
"&" | 逻辑和:如果比特对的值均为1结果为1,否则结果为0。 | :put ((0.0.0.1) & (0.0.0.1))
:put ((0.0.0.0) & (0.0.0.0)) :put ((0.0.0.0) & (0.0.0.1)) |
"<<" | 左移给定数量的比特位。 | :put (0.0.0.1 <<1)
:put (0.0.0.1 <<2) :put (0.0.0.1 <<4) |
">>" | 右移给定数量的比特位。 | :put (0.0.0.2 >>1) |
3.5、连接运算符
Opearator | Description | Example |
"." | 连接两个字符串 | |
"," | 连接两个数组或者增加新元素导数组 |
"."运算符:
[admin@MikroTik] >{ :local a "cmdschool"; :local a ".org"; :put ($a.$b); } cmdschool.org
Opearator | Description | Example |
"{}" | 包含多行的命令集,当做一条指令来处理 | {
:local i 1; :put $i; } |
"[]" | 命令替换,可以包含单个命令行 | :put [:len "cmdschool.org";]; |
"()" | 子表达式或者分组运算符 | :put ("value is"(4+5)); |
"$" | 替换运算符 | :global a 5; :put $a; |
"~" | 二进制操作符用来匹配扩展的正则表达式的值 | Print all routes which gateway ends with 202 |
“{}”运算符:
[admin@MikroTik] >{ :local a cmdschool.org; :put $a; } 1
[admin@MikroTik] >:put [:len "cmdschool.org";]; 13
1)分组运算符
[admin@MikroTik] >:put (3+4); 7
[admin@MikroTik] >:put ("=".(3+4)); =7
[admin@MikroTik] >:local a 5; :put $a; 5 [admin@MikroTik] >:put ("=$(3+4)"); =7
4.1、变量作用域
global - 定义全局变量,路由内全局有效
local - 定义本地变量,同一行物理行或逻辑行内有效,逻辑行指包含在“{}”中的代码。
4.2、变量定义
:global
定义全局变量
[admin@MikroTik] >:global a cmdschool.org; [admin@MikroTik] >:put $a; cmdschool.org
定义本地变量
[admin@MikroTik]>:local a cmdschool.org; :put $a; cmdschool.org
[admin@MikroTik] >:local a cmdschool.org; :put $a; cmdschool.org [admin@MikroTik] >:local 1 cmdschool.org; :put $1; cmdschool.org [admin@MikroTik] >:local "*" cmdschool.org; :put $"*"; cmdschool.org [admin@MikroTik] >{ :local A "cmdschool"; :put $A; :local a ".org"; :put $a; } cmdschool .org
[admin@MikroTik] >:set a "cmdschool.org";
[admin@MikroTik] >{ :local a; :set a cmdschool.org; :put $a } cmdschool.org;
Opearator | Description | Example |
num | 64位带符号整数类型 | |
bool | 布尔类型,值为true或false | |
str | 字符串类型 | |
ip | IP地址类型 | |
id | '*'为前缀的十六进制值 | |
time | 时间类型 | |
array | 数组类型 | |
nothing | 默认变量类型(未赋值前) |
number:
[admin@MikroTik] >{ :local a; :set a 1000; :put $a; :put [:typeof $a]; } 1000 num [admin@MikroTik] >
[admin@MikroTik] >{ :local a; :local b; :set a true; :set b false; :put $a; :put $b; :put [:typeof $a]; :put [:typeof $b]; } true false bool bool [admin@MikroTik] >
[admin@MikroTik] >{ :local a; :set a cmdschool.org; :put $a; :put [:typeof $a]; } cmdschool.org str [admin@MikroTik] >{ :local b; :set b "cmdschool.org"; :put $b; :put [:typeof $b]; } cmdschool.org str [admin@MikroTik] >
[admin@MikroTik] >{ :local a; :set a "192.168.1.1"; :put $a; :put [:typeof $a]; } 192.168.1.1 ip [admin@MikroTik] >
[admin@MikroTik] >{ :local b; :set b "192.168.1.1"; :put $b; :put [:typeof $b]; } 192.168.1.1 str [admin@MikroTik] >
[admin@MikroTik] >:local a *0x0; :put $a; :put [typeof $a]; *0x0 id [admin@MikroTik] >:local a *0x9; :put $a; :put [typeof $a]; *0x9 id [admin@MikroTik] >:local a *0xa; :put $a; :put [typeof $a]; *0xa id [admin@MikroTik] >:local a *0xf; :put $a; :put [typeof $a]; *0xf id [admin@MikroTik] >:local a *0xg; :put $a; :put [typeof $a]; *0xg str [admin@MikroTik] >
可以省略"0x":
[admin@MikroTik] >:local a *f; :put $a; :put [typeof $a]; *f id
[admin@MikroTik] >{ :local a; :set a 08:00:01; :put $a; :put [:typeof $a]; } 08:00:01 time [admin@MikroTik] >
[admin@MikroTik] >{ :local a; :put $a; :put [:typeof $a]; } nothing [admin@MikroTik] >
and or not in beep execute global list pick time toip typeof
delay find if local put toarray tonum while
do for led log resolve tobool tostr
environment foreach len nothing set toid totime
5、逻辑结构
5.1、顺序结构
:if
1)example1
[admin@MikroTik] >:if (1<2) do={:put true}; true
[admin@MikroTik] >:if (1<2) do { put true; put ^-^ }; true ^-^
[admin@MikroTik] >:if (1>2) do={:put true} else={:put flase}; flase
[admin@MikroTik] >:if (1>2) do { :put true } else={ :put flase :put ^-^ }; flase ^-^
:while
[admin@MikroTik] >:local i; :set i 0; :while ($i<5) do={:put $i;:set i ($i+1)}; 0 1 2 3 4 [admin@MikroTik] >{ :local i; :set i 1; :while ($i<=5) do { :put $i; :set i ($i+1) } } 1 2 3 4 5
[admin@MikroTik] >:local i; :for i from=1 to=100 step=30 do={:put $i;}; 1 3161 91 [admin@MikroTik] >{ :local i; :for i from 1 to 5 step 1 do { :put $i; } }
[admin@MikroTik] >:local i; :foreach i in [/interface find type=ether] do={:put [/interface get $i name]} ether01 ether02 ether03 ether04 ether05 ether06 ether07 ether08 ether09 ether10 sfp1 [admin@MikroTik] >{ :local i; :foreach i in [/interface find type=ether] do={ :put [/interface get $i name] } } ether01 ether02 ether03 ether04 ether05 ether06 ether07 ether08 ether09 ether10 sfp1
评论前必须登录!
注册