Freigeben über


ipv4_is_in_range()

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Überprüft, ob die IPv4-Zeichenfolgenadresse im Bereich der IPv4-Prefixnotation liegt.

Syntax

ipv4_is_in_range(Ipv4Address,Ipv4Range)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
Ipv4Address string ✔️ Ein Ausdruck, der eine IPv4-Adresse darstellt.
Ipv4Range string ✔️ Ein IPv4-Bereich oder eine Liste von IPv4-Bereichen, die mit IP-Präfixnotation geschrieben wurden.

IP-Präfixnotation

Ip-Präfixnotation (auch als CIDR-Notation bezeichnet) ist eine präzise Möglichkeit, eine IP-Adresse und die zugehörige Netzwerkmaske darzustellen. Das Format ist <base IP>/<prefix length>, wobei die Präfixlänge die Anzahl der führenden 1 Bits in der Netzmaske ist. Die Präfixlänge bestimmt den Bereich der IP-Adressen, die zum Netzwerk gehören.

Bei IPv4 ist die Präfixlänge eine Zahl zwischen 0 und 32. Die Notation 192.168.2.0/24 stellt also die IP-Adresse 192.168.2.0 mit einer Netmask von 255.255.255.255.0 dar. Diese Netmaske hat 24 führende 1 Bit oder eine Präfixlänge von 24.

Bei IPv6 ist die Präfixlänge eine Zahl zwischen 0 und 128. Daher stellt die Notation fe80::85d:e82c:9446:7994/120 die IP-Adresse fe80::85d:e82c:9446:7994 mit einer Netmaske von ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00 dar. Diese Netmaske hat 120 führende 1 Bit oder eine Präfixlänge von 120.

Gibt zurück

  • true: Wenn die lange Darstellung des ersten IPv4-Zeichenfolgenarguments im Bereich des zweiten IPv4-Zeichenfolgenarguments liegt.
  • false:Sonst.
  • null: Wenn die Konvertierung für eine der beiden IPv4-Zeichenfolgen nicht erfolgreich war.

Beispiel

datatable(ip_address:string, ip_range:string)
[
 '192.168.1.1',    '192.168.1.1',       // Equal IPs
 '192.168.1.1',    '192.168.1.255/24',  // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_is_in_range(ip_address, ip_range)

Output

ip_address ip_range result
192.168.1.1 192.168.1.1 true
192.168.1.1 192.168.1.255/24 true