Sdílet prostřednictvím

ipv6_is_in_any_range()

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Zkontroluje, jestli je řetězcová adresa IPv6 v některém ze zadaných rozsahů IPv6 adres.

Tipy týkající se výkonu

Poznámka:

Pokud se používá více než 128 hledaných termínů, je optimalizace vyhledávání v textovém indexu zakázaná, což může vést ke snížení výkonu dotazů.

Syntaxe

ipv6_is_in_any_range(Ipv6Address , Ipv6Range [ , Ipv6Range ...])

ipv6_is_in_any_range(Ipv6Address , Ipv6Ranges )

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Type Požadováno Popis
Ipv6Address string ✔️ Výraz představující adresu IPv6.
Ipv6Range string ✔️ Výraz představující rozsah IPv6 pomocí zápisu předpony IP.
Ipv6Ranges dynamic ✔️ Pole obsahující rozsahy IPv6 pomocí zápisu předpony IP.

Poznámka:

Vyžaduje se jeden nebo více řetězců IPv6Range nebo dynamické pole IPv6Ranges .

Notace předpon IP adres

Notace předpon IP (označovaná také jako zápis CIDR) je stručný způsob reprezentace IP adresy a přidružené síťové masky. Formát je <base IP>/<prefix length>, kde délka předpony je počet úvodních 1 bitů v maskách sítě. Délka předpony určuje rozsah IP adres, které patří do sítě.

U protokolu IPv4 je délka předpony číslo od 0 do 32. Zápis 192.168.2.0/24 tedy představuje IP adresu 192.168.2.0 s maskou sítě 255.255.255.255.0. Tato maska sítě má 24 úvodních 1 bitů nebo délku předpony 24.

U protokolu IPv6 je délka předpony číslo od 0 do 128. Zápis fe80::85d:e82c:9446:7994/120 představuje IP adresu fe80::85d:e82c:9446:7994 s netmask ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00. Tato maska sítě má 120 úvodních 1 bitů nebo délku předpony 120.

Návraty

  • true: Pokud je adresa IPv6 v rozsahu libovolné ze zadaných sítí IPv6.
  • false:Jinak.
  • null: Pokud převod jednoho ze dvou řetězců IPv6 nebyl úspěšný.

Příklad

let LocalNetworks=dynamic([
    "a5e:f127:8a9d:146d:e102:b5d3:c755:f6cd/112",
    "0:0:0:0:0:ffff:c0a8:ac/60"
]);
let IPs=datatable(IP:string) [
    "a5e:f127:8a9d:146d:e102:b5d3:c755:abcd",
    "a5e:f127:8a9d:146d:e102:b5d3:c755:abce",
    "a5e:f127:8a9d:146d:e102:b5d3:c755:abcf",
    "a5e:f127:8a9d:146d:e102:b5d3:c756:abd1",
];
IPs
| extend IsLocal=ipv6_is_in_any_range(IP, LocalNetworks)

Výstup

IP IsLocal
a5e:f127:8a9d:146d:e102:b5d3:c755:abcd True
a5e:f127:8a9d:146d:e102:b5d3:c755:abce True
a5e:f127:8a9d:146d:e102:b5d3:c755:abcf True
a5e:f127:8a9d:146d:e102:b5d3:c756:abd1 False

Související obsah