Get-NetAdapterBinding
Get-NetAdapterBinding
Returns a list of bindings for a network adapter.
语法
Parameter Set: ByName
Get-NetAdapterBinding [[-Name] <String[]> ] [-AllBindings] [-AsJob] [-CimSession <CimSession[]> ] [-ComponentID <String[]> ] [-DisplayName <String[]> ] [-IncludeHidden] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByInstanceID
Get-NetAdapterBinding -InterfaceDescription <String[]> [-AllBindings] [-AsJob] [-CimSession <CimSession[]> ] [-ComponentID <String[]> ] [-DisplayName <String[]> ] [-IncludeHidden] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
详细说明
The Get-NetAdapterBinding cmdlet returns a list of bindings for a network adapter. By default only the visible bindings shown in the Networking tab under the Network Adapter properties in Windows UI is returned. To get all properties for a network adapter, use the AllProperties parameter.
参数
-AllBindings
Returns all the bindings for the network adapter.
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
-AsJob
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
-CimSession<CimSession[]>
在远程会话中或在远程计算机上运行 cmdlet。输入计算机名称或会话对象,例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认为本地计算机上的当前会话。
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
-ComponentID<String[]>
Specifies the underlying name of the transport or filter in the following form.
- ms_xxxx
, such as ms_tcpip
.
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
true |
-DisplayName<String[]>
Specifies the transport or filter name shown in the Networking tab under the network adapter properties in Windows Server® 2012 and later.
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
true |
-IncludeHidden
Specifies both visible and hidden network adapters should be included. By default only visible network adapters are included. If a wildcard character is used in identifying a network adapter and this parameter has been specified, then the wildcard string is matched against both hidden and visible network adapters.
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
-InterfaceDescription<String[]>
Specifies the network adapter interface description. For a physical network adapter this is typically the name of the vendor of the network adapter followed by a part number and description, such as Contoso 12345 Gigabit Network Device
.
别名 |
ifDesc |
是否为必需? |
true |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
true |
-Name<String[]>
Specifies the name of the network adapter.
别名 |
ifAlias |
是否为必需? |
false |
位置? |
1 |
默认值 |
无 |
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
true |
-ThrottleLimit<Int32>
指定可建立的用于运行此 cmdlet 的并发操作的最大数目。如果省略了此参数或输入了值 0
,那么 Windows PowerShell® 将基于正在计算机上运行的 CIM cmdlet 的数目,计算 cmdlet 的最佳中止值。中止值仅适用于当前 cmdlet,而不适用于会话或计算机。
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
输入
输入类型是指可通过管道传送给 cmdlet 的对象的类型。
- None
输出
输出类型是 cmdlet 所发出对象的类型。
Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_NetAdapter BindingSettingData
Microsoft.Management.Infrastructure.CimInstance
对象是一个显示 Windows Management Instrumentation (WMI) 对象的包装类。井号 (#
) 后的路径提供基础 WMI 对象的命名空间和类名称。
示例
EXAMPLE 1
This example gets the bindings for the network adapter named MyAdapter.
PS C:\> Get-NetAdapterBinding -Name MyAdapter
EXAMPLE 2
This example gets all of the bindings for the network adapter named MyAdapter (unformatted).
PS C:\> Get-NetAdapterBinding -Name MyAdapter -AllBindings
EXAMPLE 3
This example gets the state of the TCP/IPv4 on the network adapter named MyAdapter using display name.
PS C:\> Get-NetAdapterBinding -Name MyAdapter -DisplayName "Internet Protocol Version 4 (TCP/IPv4)"
EXAMPLE 4
This example gets the state of the TCP/IPv4 transport on MyAdapter using component ID.
PS C:\> Get-NetAdapterBinding -Name MyAdapter -ComponentID ms_tcpip
EXAMPLE 5
This example gets the state of TCP/IPv4 and TCP/IPv6 on all visible adapters using wildcard characters.
PS C:\> Get-NetAdapterBinding –Name * -DisplayName "Internet*"