has_ipv4()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
傳回值,指出指定的 IPv4 位址是否出現在文字中。
文字中的IP位址入口必須以非英數位元正確分隔。 例如,正確分隔的IP位址如下:
- “這些要求來自:192.168.1.1、10.1.1.115 和 10.1.1.201”
- “05:04:54 127.0.0.1 GET /favicon.ico 404”
語法
has_ipv4(
source ,
ip_address )
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
source | string |
✔️ | 要搜尋的文字。 |
ip_address | string |
✔️ | 值,其中包含要搜尋的IP位址。 |
傳回
true
如果ip_address是有效的 IPv4 位址,且已在來源中找到。 否則,此函式會傳回 false
。
提示
- 若要一次搜尋許多 IPv4 位址,請使用 has_any_ipv4() 函式。
- 若要搜尋 IPv4 位址前綴,請使用 has_ipv4_prefix() 函式。
範例
正確格式化的IP位址
print result=has_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1')
輸出
result |
---|
true |
無效的IP位址
print result=has_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.0.256')
輸出
result |
---|
false |
未正確分隔的IP
print result=has_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1')
輸出
result |
---|
false |