< Back

Get-SmbClientNetworkInterface

Wed Jan 30, 2019 6:00 pm

NAME Get-SmbClientNetworkInterface



SYNOPSIS

Retrieves the network interfaces used by the SMB client.





SYNTAX

Get-SmbClientNetworkInterface [-CimSession <Microsoft.Management.Infrastructure.CimSession[]>] [-ThrottleLimit <System.Int32>] [<CommonParameters>]





DESCRIPTION

The Get-SmbClientNetworkInterface cmdlet retrieves the network interfaces used by the Server Message Block (SMB) client.





PARAMETERS

-CimSession [<Microsoft.Management.Infrastructure.CimSession[]>]

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or

Get-CimSession cmdlet. The default is the current session on the local computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-ThrottleLimit [<System.Int32>]

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is

entered, then Windows PowerShell???? calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the

computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None









OUTPUTS

Microsoft.Management.Infrastructure.CimInstance#root/Microsoft/Windows/SMB/MSFT_SmbClientNetworkInterface



The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The

path after the pound sign (#) provides the namespace and class name for the underlying WMI object.

This cmdlet returns a MSFT_SmbClientNetworkInterface object that represents the network interfaces used by the SMB client.





Example 1: Get network interfaces used by an SMB client



PS C:\\>Get-SmbClientNetworkInterface

Interface Index RSS Capable RDMA Capable Speed IpAddresses Friendly Name

--------------- ----------- ------------ ----- ----------- -------------

12 True True 32 Gbps {192.168.101.13} RDMA1

15 True True 32 Gbps {192.168.102.13} RDMA2

17 False False 0 bps {fe80::5efe:192.... isatap.{EF722F0D...

18 False False 0 bps {fe80::5efe:192.... isatap.{BD3C4A04...

19 False False 0 bps {fe80::5efe:192.... isatap.{597B0A73...

20 False False 0 bps {fe80::6065:ddbf... Local Area Conne...

32 False False 10 Gbps {172.30.182.10} ExternalVirtual

16 False False 3 Gbps {2001:4898:0:fff... isatap.corp.cont...

14 False False 1 Gbps {192.168.100.13} Internal



This command retrieves the network interfaces used by the SMB client.





Example 2: Get network interfaces used by an SMB client for a specified link speed



PS C:\\>Get-SmbClientNetworkInterface | Where-Object -Property LinkSpeed -Gt 10GB

Interface Index RSS Capable RDMA Capable Speed IpAddresses Friendly Name

--------------- ----------- ------------ ----- ----------- -------------

12 True True 32 Gbps {192.168.101.13} RDMA1

15 True True 32 Gbps {192.168.102.13} RDMA2



This command retrieves the network interfaces used by the SMB client that match the link speed of 10 gigabits or more.





Example 3: Display details for network interfaces



PS C:\\>Get-SmbClientNetworkInterface | Where-Object -Property LinkSpeed -Gt 10GB | Select-Object -Property *

FriendlyName : RDMA1

InterfaceIndex : 12

IpAddresses : {192.168.101.13}

LinkSpeed : 32000000000

RdmaCapable : True

RssCapable : True

PSComputerName :

CimClass : ROOT/Microsoft/Windows/SMB:MSFT_SmbClientNetworkInterface

CimInstanceProperties : {FriendlyName, InterfaceIndex, IpAddresses, LinkSpeed...}

CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties



FriendlyName : RDMA2

InterfaceIndex : 15

IpAddresses : {192.168.102.13}

LinkSpeed : 32000000000

RdmaCapable : True

RssCapable : True

PSComputerName :

CimClass : ROOT/Microsoft/Windows/SMB:MSFT_SmbClientNetworkInterface

CimInstanceProperties : {FriendlyName, InterfaceIndex, IpAddresses, LinkSpeed...}

CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties



This command displays all of the information retrieved from the network interfaces used by the SMB client that match the link speed of 10 gigabits or

more.







RELATED LINKS

Get-SmbServerNetworkInterface