---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# IPAddress: Bereichsbezogen, global

# IPAddress: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 Minuten Lesedauer

Die IPAddress- API stellt Methoden bereit, mit denen Sie verschiedene Status einer angegebenen IP-Adresse überprüfen können, z. B. ob sie Routingfähig, Unicast, Multicast, Öffentlich oder Reserviert ist. Außerdem können Sie die kanonische (gekürzt/Standard) und die erweiterte Form einer IP-Adresse abrufen.
Greifen Sie auf die globale IPAddress -Klasse und die zugehörigen Methoden im globalen `SNC` -Namespace zu.

In dieser API sind einige der Methoden statisch, andere nicht statisch. Die [Methoden isV4()](https://www.servicenow.com/docs/Nx_pIAmdDQVVLrYazENvfw#IPAdd-isV4_S "Bestimmt, ob die angegebene IP-Adresse eine gültige IPv4-Adresse ist.") und [isV6()](https://www.servicenow.com/docs/Nx_pIAmdDQVVLrYazENvfw#IPAdd-isV6_S "Bestimmt, ob die angegebene IP-Adresse eine gültige IPv6-Adresse ist.") bieten statische und nicht statische Implementierungen. Der Vorteil der nicht statischen Methoden besteht darin, dass Sie zum Instanziieren eines IPAddress-Objekts nicht die [IPAddress()-](https://www.servicenow.com/docs/Nx_pIAmdDQVVLrYazENvfw#IPAddressAPIBoth "Die IPAddress- API stellt Methoden bereit, mit denen Sie verschiedene Status einer angegebenen IP-Adresse überprüfen können, z. B. ob sie Routingfähig, Unicast, Multicast, Öffentlich oder Reserviert ist. Außerdem können Sie die kanonische (gekürzt/Standard) und die erweiterte Form einer IP-Adresse abrufen.") Methode aufrufen müssen.

## IPAddress: IPAddress(String ipAddress) {#ariaid-title2}

Instanziiert ein IPAddress-Objekt für die angegebene IP-Adresse.
{#IPAdd-IPAddress_S__table_hvk_txg_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge | IP-Adresse, für die das IPAddress-Objekt erstellt werden soll. |
[Tabelle : 1. Parameter]

{#IPAdd-IPAddress_S__table_hvk_txg_htb}  
Das folgende Codebeispiel zeigt, wie der IPAddress-Konstruktor beim Aufrufen einer nicht statischen IPAddress -Methode aufgerufen wird.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");

      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is routable?: " + new SNC.IPAddress(ip).isRoutable());
      gs.info("ip address 2 is routable?: " + new SNC.IPAddress(ip2).isRoutable());
    }

## IPAddress -- canonicalize(String ipAddress) {#ariaid-title3}

Gibt die kanonische Form (gekürzt/Standard) der angegebenen IP-Adresse zurück, indem alle Nullauffüllungen aus der Adresse entfernt werden.
Beispiel: Die kanonische Form der IPv6-Adresse „0000:0000:0000:0000:0000:0000:0000:0001" lautet „::1". Die kanonische Form der IPv4-Adresse „192.168.001.002" ist „192.268.1.2".  
Hinweis:  
Dies ist eine statische Methode.
{#IPAdd-canonicalize_S__table_r4h_yzg_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge oder Objekt | Zu kanonisierende IP-Adresse oder ein bereichsbezogenes IPAddress-Objekt, das die IP-Adresse enthält. |
[Tabelle : 2. Parameter]

{#IPAdd-canonicalize_S__table_r4h_yzg_htb} {#IPAdd-canonicalize_S__table_s4h_yzg_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Kanonisierte (gekürzte/standardisierte) IP-Adresse. |
[Tabelle : 3. Ergebnisse]

{#IPAdd-canonicalize_S__table_s4h_yzg_htb}  
Das folgende Beispiel zeigt, wie die bereichsbezogene Version dieser Methode zum Kanonisieren einer IPv6-IP-Adresse verwendet wird.

    function() {
      var grCMDB = new GlideRecord('cmdb_ci');
      grCMDB.get("SYS_ID");
      var ip = grCMDB.getValue('ip_address');
      gs.info("ip address: " + ip);
      gs.info("canonicalized ip: " + SNC.IPAddress.canonicalize(ip));
    }

Ausgabe:

    ip address: 0000:0000:0000:0000:0000:0000:0000:0001
    canonicalized ip: ::1

## IPAddress -- getExpanded(String ipAddress) {#ariaid-title4}

Gibt die erweiterte Form der angegebenen IP-Adresse zurück
Die erweiterte Form der IPv6-Adresse „::1" lautet beispielsweise „0000:0000:0000:0000:0000:0000:0000:0001". Die erweiterte Form der IPv4-Adresse „192.268.1.2" lautet „192.168.001.002".  
Hinweis:  
Dies ist eine statische Methode.
{#IPAdd-getExpanded_S__table_q1m_n1n_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge | Zu erweiternde IP-Adresse. |
[Tabelle : 4. Parameter]

{#IPAdd-getExpanded_S__table_q1m_n1n_htb} {#IPAdd-getExpanded_S__table_r1m_n1n_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Erweiterte IP-Adresse. |
[Tabelle : 5. Ergebnisse]

{#IPAdd-getExpanded_S__table_r1m_n1n_htb}  
Das folgende Beispiel zeigt, wie Sie die bereichsbezogene Version dieser Methode verwenden, um eine IPv6-IP-Adresse zu erweitern.

    function() {
      var grCMDB = new GlideRecord('cmdb_ci');
      grCMDB.get(SYS_ID);
      var ip = grCMDB.getValue('ip_address');
      gs.info("ip address: " + ip);
      gs.info("expanded ip: " + SNC.IPAddress.getExpanded(ip));
    }

Ausgabe:

    ip address: ::1
    expanded ip: 0000:0000:0000:0000:0000:0000:0000:0001

## IPAddress -- isLinkLocal() {#ariaid-title5}

Bestimmt, ob das angegebene IPAddress-Objekt eine Link-lokale IP-Adresse ist.
Weitere Informationen zu Link-lokalen IP-Adressen finden Sie unter [RFC 3927](https://datatracker.ietf.org/doc/html/rfc3927) und [RFC 4291](https://datatracker.ietf.org/doc/html/rfc4291).  
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isLinkLocal__table_fyr_mg4_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#IPAdd-isLinkLocal__table_fyr_mg4_htb} {#IPAdd-isLinkLocal__table_gyr_mg4_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt eine Link-Lokale Adresse ist. Gültige Werte: * wahr: IP-Adresse ist eine Link-lokale Adresse. * „falsch": IP-Adresse ist keine Link-lokale Adresse. {#IPAdd-isLinkLocal__ul_bhr_ddn_htb} |
[Tabelle : 7. Ergebnisse]

{#IPAdd-isLinkLocal__table_gyr_mg4_htb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] link-lokale Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");

      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is link local?: " + new SNC.IPAddress(ip).isLinkLocal());
      gs.info("ip address 2 is link local?: " + new SNC.IPAddress(start_ip).isLinkLocal());
    }

Ausgabe:

    ip address 1: ::1
    ip address 2: fe80:1::1
    ip address 1 is link local?: false
    ip address 2 is link local?: true

## IPAddress -- isLocalhost() {#ariaid-title6}

Bestimmt, ob das angegebene IPAddress-Objekt die Loopback-IP-Adresse ist.
Weitere Informationen zur Loopback-IP-Adresse finden Sie unter [IANA-IPv4-Adressregistrierung für spezielle Zwecke](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) und [IANA-IPv6-Adressregistrierung für spezielle Zwecke](https://www.iana.org/assignments/iana-ipv6-special-registry/iana-ipv6-special-registry.xml).  
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isLocalhost__table_kgl_g3l_3tb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 8. Parameter]

{#IPAdd-isLocalhost__table_kgl_g3l_3tb} {#IPAdd-isLocalhost__table_lgl_g3l_3tb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt die Loopback-IP-Adresse ist. Gültige Werte: * „wahr": IP-Adresse ist die Loopback-IP-Adresse. * „falsch": Die IP-Adresse ist nicht die Loopback-IP-Adresse. {#IPAdd-isLocalhost__ul_bhr_ddn_htb} |
[Tabelle : 9. Ergebnisse]

{#IPAdd-isLocalhost__table_lgl_g3l_3tb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] die Loopback-IP-Adresse sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is localhost?: " + new SNC.IPAddress(ip).isLocalhost());
      gs.info("ip address 2 is localhost?: " + new SNC.IPAddress(ip2).isLocalhost());
    }

Ausgabe:

    ip address 1: 127.0.0.1
    ip address 2: <current user's public IP Address>
    ip address 1 is localhost?: true
    ip address 2 is localhost?: false

## IPAddress -- isMulticast() {#ariaid-title7}

Bestimmt, ob das angegebene IPAddress-Objekt eine Multicast-IP-Adresse ist.
Weitere Informationen zu Multicast-IP-Adressen finden Sie unter [RFC 2365](https://datatracker.ietf.org/doc/html/rfc2365) und [RFC 3306](https://datatracker.ietf.org/doc/html/rfc3306).  
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isMulticast__table_qww_sh4_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 10. Parameter]

{#IPAdd-isMulticast__table_qww_sh4_htb} {#IPAdd-isMulticast__table_rww_sh4_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt eine Multicast-Adresse ist. Gültige Werte: * wahr: IP-Adresse ist eine Multicast-Adresse. * false: IP-Adresse ist keine Multicast-Adresse. {#IPAdd-isMulticast__ul_bhr_ddn_htb} |
[Tabelle : 11. Ergebnisse]

{#IPAdd-isMulticast__table_rww_sh4_htb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] Multicast-Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is multicast?: " + new SNC.IPAddress(ip).isMulticast());
      gs.info("ip address 2 is multicast?: " + new SNC.IPAddress(start_ip).isMulticast());
    }

Ausgabe:

    ip address 1: ::1
    ip address 2: 224.0.0.22
    ip address 1 is multicast?: false
    ip address 2 is multicast?: true

## IPAddress -- isPublic() {#ariaid-title8}

Bestimmt, ob das angegebene IPAddress-Objekt eine öffentliche IP-Adresse ist. Eine IP-Adresse gilt als öffentlich, wenn sie weitergeleitet werden kann und keine reservierte Adresse ist.
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isPublic__table_l2f_22l_3tb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 12. Parameter]

{#IPAdd-isPublic__table_l2f_22l_3tb} {#IPAdd-isPublic__table_m2f_22l_3tb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt eine öffentliche Adresse ist. Gültige Werte: * wahr: IP-Adresse ist eine öffentliche Adresse. * false: IP-Adresse ist keine öffentliche Adresse. {#IPAdd-isPublic__ul_bhr_ddn_htb} |
[Tabelle : 13. Ergebnisse]

{#IPAdd-isPublic__table_m2f_22l_3tb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] öffentliche Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is public?: " + new SNC.IPAddress(ip).isPublic());
      gs.info("ip address 2 is public?: " + new SNC.IPAddress(ip2).isPublic());
    }

Ausgabe:

    ip address 1: 2001:1::1
    ip address 2: <current user's public IP Address>
    ip address 1 is public?: false
    ip address 2 is public?: true

## IPAddress -- isReserved() {#ariaid-title9}

Bestimmt, ob das angegebene IPAddress-Objekt eine reservierte IP-Adresse ist.
Weitere Informationen zu reservierten IP-Adressen finden Sie unter [IANA IPv4 Special-Purpose Address Registry](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) und [IANA IPv6 Special-Purpose Address Registry](https://www.iana.org/assignments/iana-ipv6-special-registry/iana-ipv6-special-registry.xml).  
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isReserved__table_lpw_ffl_3tb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 14. Parameter]

{#IPAdd-isReserved__table_lpw_ffl_3tb} {#IPAdd-isReserved__table_mpw_ffl_3tb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt eine reservierte Adresse ist. Gültige Werte: * wahr: IP-Adresse ist reserviert. * „falsch": IP-Adresse ist keine reservierte Adresse. {#IPAdd-isReserved__ul_bhr_ddn_htb} |
[Tabelle : 15. Ergebnisse]

{#IPAdd-isReserved__table_mpw_ffl_3tb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] reservierte Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is reserved?: " + new SNC.IPAddress(ip).isReserved());
      gs.info("ip address 2 is reserved?: " + new SNC.IPAddress(ip2).isReserved());
    }

Ausgabe:

    ip address 1: 2001:1::1
    ip address 2: <current user's public IP Address>
    ip address 1 is reserved?: true
    ip address 2 is reserved?: false

## IPAddress -- isRoutable() {#ariaid-title10}

Bestimmt, ob das angegebene IPAddress-Objekt eine Routing-fähige IP-Adresse ist.
Eine IP-Adresse gilt als routbar, wenn es sich nicht um eine private Adresse, eine Link-Lokal-Adresse oder die Loopback-Adresse handelt. Weitere Informationen zu privaten Adressen finden Sie unter [RFC 1918](https://datatracker.ietf.org/doc/html/rfc1918) und [RFC 4193](https://datatracker.ietf.org/doc/html/rfc4193).  
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isRoutable__table_pv3_m34_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 16. Parameter]

{#IPAdd-isRoutable__table_pv3_m34_htb} {#IPAdd-isRoutable__table_qv3_m34_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt eine Routing-Adresse ist. Gültige Werte: * wahr: IP-Adresse ist eine Routing-Adresse. * „falsch": IP-Adresse ist keine routbare Adresse. {#IPAdd-isRoutable__ul_bhr_ddn_htb} |
[Tabelle : 17. Ergebnisse]

{#IPAdd-isRoutable__table_qv3_m34_htb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] routbare Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is routable?: " + new SNC.IPAddress(ip).isRoutable());
      gs.info("ip address 2 is routable?: " + new SNC.IPAddress(ip2).isRoutable());
    }

Ausgabe:

    ip address 1: ::1
    ip address 2: <current user's public IP Address>
    ip address 1 is routable?: false
    ip address 2 is routable?: true

## IPAddress -- isSameVersionAs(String ipAddress) {#ariaid-title11}

Bestimmt, ob das übergebene IPAddress-Objekt die gleiche Version (IPv4 oder IPv6) wie die angegebene IP-Adresse hat.
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isSameVersionAs_S__table_x2x_4f4_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge | IP-Adresse, die mit der IP-Adresse im übergebenen IPAddress-Objekt verglichen werden soll. |
[Tabelle : 18. Parameter]

{#IPAdd-isSameVersionAs_S__table_x2x_4f4_htb} {#IPAdd-isSameVersionAs_S__table_y2x_4f4_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die angegebene IP-Adresse dieselbe Version wie die im IPAddress-Objekt aufweist. Gültige Werte: * „wahr": Die IP-Adressenversion ist dieselbe. * „falsch": IP-Adressversion ist anders. {#IPAdd-isSameVersionAs_S__ul_bhr_ddn_htb} |
[Tabelle : 19. Ergebnisse]

{#IPAdd-isSameVersionAs_S__table_y2x_4f4_htb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu vergleichen, ob verschiedene IP-Adressen dieselbe Version (IPv4 oder IPv6) aufweisen.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      var end_ip = grDiscover.getValue('end_ip_address');
      gs.info("ip address 1: "+ ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 3: " + end_ip);
      var ip1 = new SNC.IPAddress(ip);
      var ip2 = new SNC.IPAddress(start_ip);
      var ip3 = new SNC.IPAddress(end_ip);
      gs.info("ip address 1 is same version as ip address 2?: " + ip1.isSameVersionAs(ip2));
      gs.info("ip address 1 is same version as itself?: " + ip1.isSameVersionAs(ip1));
      gs.info("ip address 2 is same version as ip address 3?: " + ip2.isSameVersionAs(ip3));
    }

Ausgabe:

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 3: ::3
    ip address 1 is same version as ip address 2?: false
    ip address 1 is same version as itself?: true
    ip address 2 is same version as ip address 3?: true

## IPAddress: isUnicast() {#ariaid-title12}

Bestimmt, ob das angegebene IPAddress-Objekt eine Unicast-IP-Adresse ist.
Eine Unicast-Adresse ist effektiv eine Adresse, die kein Multicast ist.  
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-isUnicast__table_zk3_bhl_3tb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 20. Parameter]

{#IPAdd-isUnicast__table_zk3_bhl_3tb} {#IPAdd-isUnicast__table_al3_bhl_3tb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das IP-Adressobjekt eine Unicast-Adresse ist. Gültige Werte: * wahr: IP-Adresse ist eine Unicast-Adresse. * „falsch": IP-Adresse ist keine Unicast-Adresse. {#IPAdd-isUnicast__ul_bhr_ddn_htb} |
[Tabelle : 21. Ergebnisse]

{#IPAdd-isUnicast__table_al3_bhl_3tb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] Unicast-Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is unicast?: " + new SNC.IPAddress(ip).isUnicast());
      gs.info("ip address 2 is unicast?: " + new SNC.IPAddress(ip2).isUnicast());
    }

Ausgabe:

    ip address 1: 224.0.0.22
    ip address 2: <current user's public IP Address>
    ip address 1 is unicast?: false
    ip address 2 is unicast?: true

## IPAddress -- isV4(String ipAddress) {#ariaid-title13}

Bestimmt, ob die angegebene IP-Adresse eine gültige IPv4-Adresse ist.
Diese Methode hat sowohl statische als auch nicht statische Implementierungen. Die Art und Weise, wie Sie die beiden Methodentypen aufrufen, unterscheidet sich geringfügig. Für die nicht statische Implementierung müssen Sie nicht zuerst ein IPAddress-Objekt instanziieren, und Sie übergeben die IP-Adresse in der IPAddress-Klassenreferenz. Beide geben die gleiche Antwort zurück.
{#IPAdd-isV4_S__table_hrb_3gn_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge | Zu validierende IP-Adresse. Bei der nicht statischen Implementierung wird die IP-Adresse in der IPAddress-Klassenreferenz anstelle des Methodenaufrufs übergeben. Beispiel `: New SNC.IPAddress("::1").isV4();`. |
[Tabelle : 22. Parameter]

{#IPAdd-isV4_S__table_hrb_3gn_htb} {#IPAdd-isV4_S__table_irb_3gn_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die angegebene IP-Adresse eine gültige IPv4-Adresse ist. Gültige Werte: * true: IP-Adresse ist gültig. * „falsch": IP-Adresse ist ungültig. {#IPAdd-isV4_S__ul_bhr_ddn_htb} |
[Tabelle : 23. Ergebnisse]

{#IPAdd-isV4_S__table_irb_3gn_htb}  
Das folgende Beispiel zeigt, wie die bereichsbezogene statische Version dieser Methode verwendet wird, um zu überprüfen, ob IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] gültige IPv4-Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is v4?: " + SNC.IPAddress.isV4(ip));
      gs.info(("ip address 2 is v4?: " + SNC.IPAddress.isV4(start_ip));
    }

Ausgabe:

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 1 is v4?: true
    ip address 2 is v4?: false

Das folgende Beispiel zeigt, wie Sie die nicht statische Version dieser Methode verwenden, um zu überprüfen, ob IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] gültige IPv4-Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is v4?: " + new SNC.IPAddress(ip).isV4());
      gs.info("ip address 2 is v4?: " + new SNC.IPAddress(start_ip).isV4());
    }

Ausgabe:

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 1 is v4?: true
    ip address 2 is v4?: false

## IPAddress -- isV6(String ipAddress) {#ariaid-title14}

Bestimmt, ob die angegebene IP-Adresse eine gültige IPv6-Adresse ist.
Diese Methode hat sowohl statische als auch nicht statische Implementierungen. Die Art und Weise, wie Sie die beiden Methodentypen aufrufen, unterscheidet sich geringfügig. Für die nicht statische Implementierung müssen Sie nicht zuerst ein IPAddress-Objekt instanziieren, und Sie übergeben die IP-Adresse in der IPAddress-Klassenreferenz. Beide geben die gleiche Antwort zurück.
{#IPAdd-isV6_S__table_nkk_sgn_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge | Zu validierende IP-Adresse. Bei der nicht statischen Implementierung wird die IP-Adresse in der IPAddress-Klassenreferenz anstelle des Methodenaufrufs übergeben. Beispiel `: New SNC.IPAddress("::1").isV6();`. |
[Tabelle : 24. Parameter]

{#IPAdd-isV6_S__table_nkk_sgn_htb} {#IPAdd-isV6_S__table_okk_sgn_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die angegebene IP-Adresse eine gültige IPv6-Adresse ist. Gültige Werte: * true: IP-Adresse ist gültig. * „falsch": IP-Adresse ist ungültig. {#IPAdd-isV6_S__ul_bhr_ddn_htb} |
[Tabelle : 25. Ergebnisse]

{#IPAdd-isV6_S__table_okk_sgn_htb}  
Das folgende Beispiel zeigt, wie die bereichsbezogene statische Version dieser Methode verwendet wird, um zu überprüfen, ob IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] gültige IPv6-Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get(SYS_ID);
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is v6?: " + SNC.IPAddress.isV6(ip));
      gs.info(("ip address 2 is v6?: " + SNC.IPAddress.isV6(start_ip));
    }

Ausgabe:

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 1 is v6?: false
    ip address 2 is v6?: true

Das folgende Beispiel zeigt, wie die bereichsbezogene nicht statische Version dieser Methode verwendet wird, um zu überprüfen, ob IP-Adressen in einem Datensatz in der Tabelle „Discovery-IP-Bereiche" \[discovery_range_item\] gültige IPv6-Adressen sind.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");

      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);

      gs.info("ip address 1 is v6?: " + new SNC.IPAddress(ip).isV6());
      gs.info("ip address 2 is v6?: " + new SNC.IPAddress(start_ip).isV6());

    }

Ausgabe:

    ip address 1: 192.168.0.1
    ip address 2: ::1
    ip address 1 is v6?: false
    ip address 2 is v6?: true

## IPAddress -- isValid(String ipAddress) {#ariaid-title15}

Bestimmt, ob die angegebene IP-Adresse eine gültige IPv4- oder IPv6-Adresse ist.
Hinweis:  
Dies ist eine statische Methode.
{#IPAdd-isValid_S__table_onf_mcn_htb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ipAddress | Zeichenfolge | Zu validierende IP-Adresse. |
[Tabelle : 26. Parameter]

{#IPAdd-isValid_S__table_onf_mcn_htb} {#IPAdd-isValid_S__table_pnf_mcn_htb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die angegebene IP-Adresse eine gültige IPv4- oder IPv6-Adresse ist. Gültige Werte: * true: IP-Adresse ist gültig. * „falsch": IP-Adresse ist ungültig. {#IPAdd-isValid_S__ul_bhr_ddn_htb} |
[Tabelle : 27. Ergebnisse]

{#IPAdd-isValid_S__table_pnf_mcn_htb}  
Das folgende Codebeispiel zeigt, wie die bereichsbezogene Version dieser Methode verwendet wird, um zu überprüfen, ob die IP-Adresse in einem Datensatz innerhalb der Konfigurationselemente \[cmdb_ci\] gültig ist.

    function() {
      var grCMDB = new GlideRecord('cmdb_ci');
      grCMDB.get("SYS_ID");
      var ip = grCMDB.getValue('ip_address');
      gs.info("ip address: " + ip)
      var ipAddress = new SNC.IPAddress(ip);
      gs.info("ip is valid?: " + ipAddress.isValid())
    }

Ausgabe:

    ip address: 127.0.0.1
    ip is valid?: true

## IPAddress -- toExpanded() {#ariaid-title16}

Gibt die erweiterte Form eines IPAddress-Objekts zurück.
Hinweis:  
Dies ist eine nicht statische Methode.
{#IPAdd-toExpanded__table_xn2_mjl_3tb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 28. Parameter]

{#IPAdd-toExpanded__table_xn2_mjl_3tb} {#IPAdd-toExpanded__table_yn2_mjl_3tb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Erweiterte IP-Adresse. |
[Tabelle : 29. Ergebnisse]

{#IPAdd-toExpanded__table_yn2_mjl_3tb}  
Das folgende Beispiel zeigt, wie Sie die bereichsbezogene Version dieser Methode verwenden, um eine IPv6-IP-Adresse zu erweitern.

    function() {
      var grDiscover = new GlideRecord('cmdb_ci');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('ip_address');
      gs.info("ip address: " + ip);
      gs.info("expanded ip address: " + new SNC.IPAddress(ip).toExpanded());
    }

Ausgabe:

    ip address: 2001:41::1
    expanded ip address: 2001:0041:0000:0000:0000:0000:0000:0001