Dela via

ipv4_is_in_any_range()

  • Artikel

Kontrollerar om IPv4-strängadressen finns i något av de angivna IPv4-adressintervallen.

Syntax

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

ipv4_is_in_any_range(Ipv4Address,Ipv4Ranges)

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
Ipv4Address string ✔️ Ett uttryck som representerar en IPv4-adress.
Ipv4Range string ✔️ Ett IPv4-intervall eller en lista över IPv4-intervall skrivna med IP-prefixnotation.
Ipv4Ranges dynamic ✔️ En dynamisk matris som innehåller IPv4-intervall skrivna med IP-prefixnotation.

Anteckning

Antingen krävs en eller flera IPv4Range-strängar eller en dynamisk IPv4Ranges-matris .

IP-prefixnotation

IP-prefixnotation (kallas även CIDR-notation) är ett kortfattat sätt att representera en IP-adress och dess associerade nätverksmask. Formatet är <base IP>/<prefix length>, där prefixets längd är antalet inledande 1 bitar i nätmasken. Prefixets längd avgör intervallet med IP-adresser som tillhör nätverket.

För IPv4 är prefixets längd ett tal mellan 0 och 32. Notationen 192.168.2.0/24 representerar alltså IP-adressen 192.168.2.0 med nätmasken 255.255.255.0. Nätmasken har 24 inledande 1 bitar, eller en prefixlängd på 24.

För IPv6 är prefixets längd ett tal mellan 0 och 128. Så notationen fe80::85d:e82c:9446:7994/120 representerar IP-adressen fe80::85d:e82c:9446:7994 med en nätmask av ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffffff:ff00. Denna nätmask har 120 inledande 1 bitar, eller en prefixlängd på 120.

Returer

  • true: Om IPv4-adressen finns i intervallet för något av de angivna IPv4-nätverken.
  • false:Annars.
  • null: Om konverteringen för en av de två IPv4-strängarna inte lyckades.

Exempel

Syntax med hjälp av lista över strängar

Köra frågan

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')

Resultat

Resultat
true

Syntax med dynamisk matris

Köra frågan

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

Resultat

Resultat
true

Utöka tabellen med IPv4-intervallkontroll

Köra frågan

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)

Resultat

IP-adress IsLocal
10.1.2.3 true
192.168.1.5 true
123.1.11.21 falskt
1.1.1.1 falskt

Relaterat innehåll