共用方式為

ipv6_is_match()

  • 發行項

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

比對兩個 IPv6 或 IPv4 網路位址字串。 這兩個 IPv6/IPv4 字串會剖析和比較，同時考慮從自變數前置詞計算的結合 IP 前置詞遮罩，以及選擇性 prefix 自變數。

注意

函式可以接受和比較代表 IPv6 和 IPv4 網路位址的自變數。 如果呼叫端知道自變數採用 IPv4 格式，請使用 ipv4_is_match（） 函式。 此函式會導致更好的運行時間效能。

語法

ipv6_is_match(ip1,ip2[ ,前置詞])

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
ip1、 ip2 string ✔️ 表示 IPv6 或 IPv4 位址的表達式。 您可以使用IP前置詞表示法來遮罩 IPv6 和 IPv4 字串。
prefix int 從 0 到 128 的整數，表示要考慮的最大有效位數目。

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：如果第一個 IPv6/IPv4 字串自變數的長表示法等於第二個 IPv6/IPv4 字串自變數。
  • false：否則。
  • null：如果兩個 IPv6/IPv4 字串之一的轉換未成功。

範例

IPv6/IPv4 比較相等大小寫 - IPv6/IPv4 字串中指定的IP前置詞表示法

datatable(ip1_string:string, ip2_string:string)
[
 // IPv4 are compared as IPv6 addresses
 '192.168.1.1',    '192.168.1.1',       // Equal IPs
 '192.168.1.1/24', '192.168.1.255',     // 24 bit IP4-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255/24',  // 24 bit IP4-prefix is used for comparison
 '192.168.1.1/30', '192.168.1.255/24',  // 24 bit IP4-prefix is used for comparison
  // IPv6 cases
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7994',         // Equal IPs
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998',     // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7998/120',     // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998/120', // 120 bit IP6-prefix is used for comparison
 // Mixed case of IPv4 and IPv6
 '192.168.1.1',      '::ffff:c0a8:0101', // Equal IPs
 '192.168.1.1/24',   '::ffff:c0a8:01ff', // 24 bit IP-prefix is used for comparison
 '::ffff:c0a8:0101', '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 = ipv6_is_match(ip1_string, ip2_string)

輸出

ip1_string ip2_string result
192.168.1.1 192.168.1.1 1
192.168.1.1/24 192.168.1.255 1
192.168.1.1 192.168.1.255/24 1
192.168.1.1/30 192.168.1.255/24 1
fe80：：85d：e82c：9446：7994 fe80：：85d：e82c：9446：7994 1
fe80：：85d：e82c：9446：7994/120 fe80：：85d：e82c：9446：7998 1
fe80：：85d：e82c：9446：7994 fe80：：85d：e82c：9446：7998/120 1
fe80：：85d：e82c：9446：7994/120 fe80：：85d：e82c：9446：7998/120 1
192.168.1.1 ：：ffff：c0a8：0101 1
192.168.1.1/24 ：：ffff：c0a8：01ff 1
：：ffff：c0a8：0101 192.168.1.255/24 1
::192.168.1.1/30 192.168.1.255/24 1

IPv6/IPv4 比較相等大小寫- IPv6/IPv4 字串中指定的IP前置詞表示法，以及作為函式的其他自變數ipv6_is_match()

datatable(ip1_string:string, ip2_string:string, prefix:long)
[
 // IPv4 are compared as IPv6 addresses 
 '192.168.1.1',    '192.168.1.0',   31, // 31 bit IP4-prefix is used for comparison
 '192.168.1.1/24', '192.168.1.255', 31, // 24 bit IP4-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255', 24, // 24 bit IP4-prefix is used for comparison
   // IPv6 cases
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7995',     127, // 127 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/127', 'fe80::85d:e82c:9446:7998', 120, // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998', 127, // 120 bit IP6-prefix is used for comparison
 // Mixed case of IPv4 and IPv6
 '192.168.1.1/24',   '::ffff:c0a8:01ff', 127, // 127 bit IP6-prefix is used for comparison
 '::ffff:c0a8:0101', '192.168.1.255',    120, // 120 bit IP6-prefix is used for comparison
 '::192.168.1.1/30', '192.168.1.255/24', 127, // 120 bit IP6-prefix is used for comparison
]
| extend result = ipv6_is_match(ip1_string, ip2_string, prefix)

輸出

ip1_string ip2_string prefix result
192.168.1.1 192.168.1.0 31 1
192.168.1.1/24 192.168.1.255 31 1
192.168.1.1 192.168.1.255 24 1
fe80：：85d：e82c：9446：7994 fe80：：85d：e82c：9446：7995 127 1
fe80：：85d：e82c：9446：7994/127 fe80：：85d：e82c：9446：7998 120 1
fe80：：85d：e82c：9446：7994/120 fe80：：85d：e82c：9446：7998 127 1
192.168.1.1/24 ：：ffff：c0a8：01ff 127 1
：：ffff：c0a8：0101 192.168.1.255 120 1
::192.168.1.1/30 192.168.1.255/24 127 1

相關內容

  • IPv4/IPv6 函式概 觀