Summarize interface IP configuration

Before you begin

PowerShell 7 or later on Windows.
Requires the Windows NetTCPIP module.

What this script changesRead-only local report. It does not start services, install updates, delete files, or change configuration. Output may contain account, hardware, path, or network information; review before sharing.

Set up your example

Save the download as windows-ip-configuration.ps1.
Open PowerShell 7 in the download folder.
Run pwsh -NoProfile -File ./windows-ip-configuration.ps1 -Help, then inspect its parameter block.

This recipe uses your own local input or creates its own example output. Follow the setup steps below.

Download the ZIP, extract it, and open a terminal inside the extracted folder. The source file is windows-ip-configuration.ps1.

Run the script

pwsh -NoProfile -File ./windows-ip-configuration.ps1

If your system uses python3 instead of python, use that command for Python examples. Keep paths containing spaces in quotes. Required inputs and optional settings are described in the code and setup steps.

What to expect

A Wi-Fi row shows its local addresses and configured resolver.

The complete script

#Requires -Version 7.0
[CmdletBinding()]
param([switch]$Help,[switch]$AsJson)
$ErrorActionPreference='Stop'
if ($Help) { Write-Output 'Collect IPv4, IPv6, gateways, and DNS servers by local interface. Use -AsJson for structured output.'; exit 0 }
function Show-Report { param([object]$Data) if ($AsJson) { ConvertTo-Json -InputObject @($Data) -Depth 8 } else { $Data | Format-Table -AutoSize | Out-String -Width 240 | Write-Output } }
try {
Show-Report (Get-NetIPConfiguration -All | ForEach-Object {[pscustomobject]@{Interface=$_.InterfaceAlias;IPv4=($_.IPv4Address.IPAddress -join ', ');IPv6=($_.IPv6Address.IPAddress -join ', ');Gateway=($_.IPv4DefaultGateway.NextHop -join ', ');DNS=($_.DNSServer.ServerAddresses -join ', ')}})

} catch { Write-Error $_.Exception.Message; exit 1 }

Open source as plain text · Download source and sample files

How it works

Collect IPv4, IPv6, gateways, and DNS servers by local interface.
The script queries local Windows data and formats a snapshot without changing settings.
-AsJson changes presentation to JSON for comparison between runs.

Make it your own

Adjust the report

Add -Detailed to Get-NetIPConfiguration and select additional properties.

Capture JSON

Add -AsJson and redirect to a new unused filename. Shell redirection can overwrite an existing file, so choose a fresh name.

Change one setting at a time, run it again on sample data, and compare the output. The customization guide walks through this process.

If something goes wrong

A command is unavailable or access is denied.

Requires the Windows NetTCPIP module. Use only permissions you are authorized to use; protected records may require elevation.

No rows are returned.

No matching data can be valid. Remove optional filters and confirm this Windows edition exposes the requested information.

Reference & next steps

Microsoft PowerShell documentation ↗

These official references explain the underlying tools. The Scriptage example and guide are original instructional content. See verification notes for what has been checked and the limits of those checks.

Copies a template for your own notes. It does not send anything.