请求开发PowerShell自定义Cmdlet：查询网卡信息及多参数支持

下面是满足需求的PowerShell脚本，实现了指定网卡查询、结果保存到文件，以及内置帮助功能：

<#
.SYNOPSIS
输出本地计算机的网络适配器信息与属性。

.DESCRIPTION
该脚本可列出所有网络适配器的详细信息，支持通过-Name参数指定特定网卡，还能通过-File参数将结果保存到指定文件。使用-?参数可查看此帮助信息。

.PARAMETER Name
指定要查询的网络适配器名称（支持模糊匹配），若不指定则返回所有适配器信息。

.PARAMETER File
指定结果保存的文件路径，若指定则将输出内容写入该文件，同时在控制台显示。

.EXAMPLE
.\Get-NetAdapterInfo.ps1
输出所有网络适配器的信息。

.EXAMPLE
.\Get-NetAdapterInfo.ps1 -Name "以太网"
输出名称包含"以太网"的网络适配器信息。

.EXAMPLE
.\Get-NetAdapterInfo.ps1 -File "C:\temp\NetAdapters.txt"
将所有网络适配器信息保存到指定文件，并在控制台显示。

.EXAMPLE
.\Get-NetAdapterInfo.ps1 -Name "Wi-Fi" -File "C:\temp\WiFiInfo.txt"
将名称包含"Wi-Fi"的适配器信息保存到指定文件，并在控制台显示。
#>

param(
    [string]$Name,
    [string]$File
)

# 获取网络适配器信息
if ($Name) {
    $adapterInfo = Get-NetAdapter -Name "*$Name*" | Select-Object Name, InterfaceDescription, InterfaceIndex, Status, MacAddress, LinkSpeed
} else {
    $adapterInfo = Get-NetAdapter | Select-Object Name, InterfaceDescription, InterfaceIndex, Status, MacAddress, LinkSpeed
}

# 输出信息到控制台
$adapterInfo | Format-Table -AutoSize

# 若指定文件路径则保存结果
if ($File) {
    $adapterInfo | Format-Table -AutoSize | Out-File -FilePath $File -Encoding UTF8
    Write-Host "`n信息已成功保存到文件: $File"
}

脚本说明 #

• 参数说明：
  • -Name：可选参数，用于指定要查询的网卡名称，支持通配符模糊匹配，比如-Name "Wi-Fi"会匹配所有名称包含Wi-Fi的适配器。
  • -File：可选参数，指定结果保存的文件路径，脚本会将查询结果写入该文件，同时在控制台输出。
• 帮助查看：执行脚本时添加-?参数即可查看详细帮助，比如：

  .\Get-NetAdapterInfo.ps1 -?
  

• 使用前提：需要PowerShell 5.1及以上版本，且运行脚本的用户需具备读取网络适配器信息的权限。

内容的提问来源于stack exchange，提问作者Vladyslav Ivanov