共用方式為

ipv4_is_in_any_range()

  • 發行項

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

檢查 IPv4 字串位址是否位於任何指定的 IPv4 位址範圍中。

效能祕訣

注意

使用超過 128 個搜尋字詞時，會停用文字索引查閱優化，這可能會導致查詢效能降低。

語法

ipv4_is_in_any_range(Ipv4Address , Ipv4Range [ , Ipv4Range ...])

ipv4_is_in_any_range(Ipv4Address , Ipv4Ranges )

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
Ipv4Address string ✔️ 表示 IPv4 位址的表達式。
Ipv4Range string ✔️ 以IP前置詞表示法撰寫的IPv4範圍或IPv4範圍清單。
Ipv4Ranges dynamic ✔️ 動態陣列，包含以 IP前置詞表示法撰寫的IPv4範圍。

注意

需要一或多個 IPv4Range 字串或 IPv4Ranges 動態陣列。

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 字串之一的轉換未成功。

範例

使用字串清單的語法

print Result=ipv4_is_in_any_range('192.168.1.6', '192.168.1.1/24', '10.0.0.1/8', '127.1.0.1/16')

輸出

結果
true

使用動態數位語法

print Result=ipv4_is_in_any_range("127.0.0.1", dynamic(["127.0.0.1", "192.168.1.1"]))

輸出

結果
true

使用 IPv4 範圍檢查擴充數據表

let LocalNetworks=dynamic([
    "192.168.1.1/16",
    "127.0.0.1/8",
    "10.0.0.1/8"
]);
let IPs=datatable(IP:string) [
    "10.1.2.3",
    "192.168.1.5",
    "123.1.11.21",
    "1.1.1.1"
];
IPs
| extend IsLocal=ipv4_is_in_any_range(IP, LocalNetworks)

輸出

IP IsLocal
10.1.2.3 true
192.168.1.5 true
123.1.11.21 false
1.1.1.1 false

相關內容

  • IPv4/IPv6 函式概 觀
  • IPv4 文字比對函式概 觀