ipv4_is_in_any_range()
Überprüft, ob sich die IPv4-Zeichenfolgenadresse in einem der angegebenen IPv4-Adressbereiche befindet.
Syntax
ipv4_is_in_any_range(
Ipv4Address,
Ipv4Range [ ,
Ipv4Range ...] )
ipv4_is_in_any_range(
Ipv4Address,
Ipv4Ranges)
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
Name | Typ | 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. |
Ipv4Ranges | dynamic |
✔️ | Ein dynamisches Array mit IPv4-Bereichen, die mit IP-Präfixnotation geschrieben wurden. |
Hinweis
Es ist entweder eine oder mehrere IPv4Range-Zeichenfolgen oder ein dynamisches IPv4Ranges-Array erforderlich.
IP-Präfixnotation
Die 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 Netzmaske von 255.255.255.0 dar. Diese Netzmaske hat 24 führende 1 Bits oder eine Präfixlänge von 24.
Bei IPv6 ist die Präfixlänge eine Zahl zwischen 0 und 128. Die Notation fe80::85d:e82c:9446:7994/120 stellt also die IP-Adresse fe80::85d:e82c:9446:7994 mit einer Netzmaske von ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00 dar. Diese Netzmaske hat 120 führende 1 Bits oder eine Präfixlänge von 120.
Gibt zurück
true
: Wenn sich die IPv4-Adresse im Bereich eines der angegebenen IPv4-Netzwerke befindet.false
:Andernfalls.null
: Wenn die Konvertierung für eine der beiden IPv4-Zeichenfolgen nicht erfolgreich war.
Beispiele
Syntax unter Verwendung einer Liste von Zeichenfolgen
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')
Ausgabe
Ergebnis |
---|
true |
Syntax mit dynamischem Array
print Result=ipv4_is_in_any_range("127.0.0.1", dynamic(["127.0.0.1", "192.168.1.1"]))
Ausgabe
Ergebnis |
---|
true |
Erweitern der Tabelle mit IPv4-Bereichsprüfung
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)
Ausgabe
IP | IstLokal |
---|---|
10.1.2.3 | true |
192.168.1.5 | true |
123.1.11.21 | false |
1.1.1.1 | false |
Verwandte Inhalte
- Übersicht über IPv4/IPv6-Funktionen
- Übersicht über IPv4-Textüberstimmungsfunktionen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für