ipv4_is_match()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
比對兩個 IPv4 字串。 這兩個 IPv4 字串會剖析和比較,同時考慮從自變數前置詞計算的結合 IP 前置詞遮罩,以及選擇性 prefix
自變數。
語法
ipv4_is_match(
ip1,
ip2[ ,
前置詞])
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
ip1、 ip2 | string |
✔️ | 表示 IPv4 位址的表達式。 您可以使用 IP前置詞表示法來遮罩 IPv4 字串。 |
prefix | int |
從 0 到 32 的整數,代表要考慮的最重要位數目。 |
IP 前置詞表示法
IP 前置詞表示法(也稱為 CIDR 表示法)是表示IP位址及其相關聯網路遮罩的簡潔方式。 格式為 <base IP>/<prefix length>
,其中前置長度是 netmask 中前置 1 位的數目。 前置詞長度決定屬於網路的IP位址範圍。
針對 IPv4,前置長度是介於 0 到 32 之間的數位。 因此表示法 192.168.2.0/24 代表 IP 位址 192.168.2.0,淨掩碼為 255.255.255.0。 此網路掩碼有 24 個前置 1 位,或前置長度為 24。
針對 IPv6,前置長度是介於 0 到 128 之間的數位。 因此,表示法 fe80::85d:e82c:9446:7994/120 代表 IP 位址 fe80::85d:e82c:9446:7994,具有 ff:ffff:ff00 的凈掩碼。 此 netmask 有 120 個前置 1 位,或前置長度為 120。
傳回
true
:如果第一個 IPv4 字串自變數的長表示法等於第二個 IPv4 字串自變數。false
:否則。null
:如果兩個 IPv4 字串之一的轉換未成功。
注意
針對不是範圍的 IPv4 位址進行比對時,建議您使用 equals 運算子 (==
),以提升效能。
範例
簡單範例
print ipv4_is_match('192.168.1.1/24', '192.168.1.255')
輸出
print_0 |
---|
true |
IPv4 比較相等 - IPv4 字串內指定的IP前置詞表示法
datatable(ip1_string:string, ip2_string:string)
[
'192.168.1.0', '192.168.1.0', // Equal IPs
'192.168.1.1/24', '192.168.1.255', // 24 bit IP-prefix is used for comparison
'192.168.1.1', '192.168.1.255/24', // 24 bit IP-prefix is used for comparison
'192.168.1.1/30', '192.168.1.255/24', // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_is_match(ip1_string, ip2_string)
輸出
ip1_string | ip2_string | result |
---|---|---|
192.168.1.0 | 192.168.1.0 | true |
192.168.1.1/24 | 192.168.1.255 | true |
192.168.1.1 | 192.168.1.255/24 | true |
192.168.1.1/30 | 192.168.1.255/24 | true |
IPv4 比較相等 - IPv4 字串內指定的IP前置詞表示法,以及函式的其他自變數ipv4_is_match()
datatable(ip1_string:string, ip2_string:string, prefix:long)
[
'192.168.1.1', '192.168.1.0', 31, // 31 bit IP-prefix is used for comparison
'192.168.1.1/24', '192.168.1.255', 31, // 24 bit IP-prefix is used for comparison
'192.168.1.1', '192.168.1.255', 24, // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_is_match(ip1_string, ip2_string, prefix)
輸出
ip1_string | ip2_string | prefix | result |
---|---|---|---|
192.168.1.1 | 192.168.1.0 | 31 | true |
192.168.1.1/24 | 192.168.1.255 | 31 | true |
192.168.1.1 | 192.168.1.255 | 24 | true |