ipv4_is_private()
適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
檢查 IPv4 字串位址是否屬於一組專用網IP。
專用網位址 最初已定義，以協助延遲 IPv4 位址耗盡。 源自或尋址至私人IP位址的IP封包無法透過公用因特網路由傳送。
私人 IPv4 位址
因特網工程工作隊（IETF）已指示因特網指派號碼授權單位（IANA）為專用網保留下列 IPv4 位址範圍：
| IP 位址範圍 | 位址數目 | 最大的 CIDR 區塊 （子網遮罩） |
|---|---|---|
| 10.0.0.0 – 10.255.255.255 | 16777216 | 10.0.0.0/8 (255.0.0.0) |
| 172.16.0.0 – 172.31.255.255 | 1048576 | 172.16.0.0/12 (255.240.0.0) |
| 192.168.0.0 – 192.168.255.255 | 65536 | 192.168.0.0/16 (255.255.0.0) |
ipv4_is_private('192.168.1.1/24') == true
ipv4_is_private('10.1.2.3/24') == true
ipv4_is_private('202.1.2.3') == false
ipv4_is_private("127.0.0.1") == false
語法
ipv4_is_private(ip)
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| ip | string |
✔️ | 表示 IPv4 位址的表達式。 您可以使用 IP前置詞表示法來遮罩 IPv4 字串。 |
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 位址屬於任何專用網範圍。false：否則。null：如果剖析輸入為 IPv4 位址字串未成功。
範例：檢查 IPv4 是否屬於專用網
datatable(ip_string:string)
[
'10.1.2.3',
'192.168.1.1/24',
'127.0.0.1',
]
| extend result = ipv4_is_private(ip_string)
輸出
| ip_string | result |
|---|---|
| 10.1.2.3 | true |
| 192.168.1.1/24 | true |
| 127.0.0.1 | false |