Get-SmbServerNetworkInterface

NAME Get-SmbServerNetworkInterface



SYNOPSIS

Retrieves the network interfaces used by the SMB server.





SYNTAX

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





DESCRIPTION

The Get-SmbServerNetworkInterface cmdlet retrieves the network interfaces that are used by the Server Message Block (SMB) server.





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_SmbServerNetworkInterface



The MSFT_SmbServerNetworkInterface object represents the network interfaces of the SMB server.





Example 1: Get network interfaces



PS C:\\>Get-SmbServerNetworkInterface

Scope Name Interface Index RSS Capable RDMA Capable Speed IpAddress

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

Contoso-FS 14 False False 1 Gbps 192.168.100.22

Contoso-FS 12 True True 32 Gbps 192.168.101.22

Contoso-FS 15 True True 32 Gbps 192.168.102.22

* 15 True True 32 Gbps 192.168.102.22

* 15 True True 32 Gbps 192.168.102.11

* 14 False False 1 Gbps 192.168.100.22

* 14 False False 1 Gbps 192.168.100.11

* 13 False False 1 Gbps 172.30.182.8

* 12 True True 32 Gbps 192.168.101.22

* 12 True True 32 Gbps 192.168.101.11

Contoso-SO 15 True True 32 Gbps 192.168.102.11

Contoso-SO 14 False False 1 Gbps 192.168.100.11

Contoso-SO 12 True True 32 Gbps 192.168.101.11

FE80::C8C0:F65D:... 13 False False 1 Gbps 172.30.182.8



This command retrieves the network interfaces that are used by the SMB server.





Example 2: Get network interfaces that match a property



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

Scope Name Interface Index RSS Capable RDMA Capable Speed IpAddress

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

Contoso-FS 12 True True 32 Gbps 192.168.101.22

Contoso-FS 15 True True 32 Gbps 192.168.102.22

* 15 True True 32 Gbps 192.168.102.22

* 15 True True 32 Gbps 192.168.102.11

* 12 True True 32 Gbps 192.168.101.22

* 12 True True 32 Gbps 192.168.101.11

Contoso-SO 15 True True 32 Gbps 192.168.102.11

Contoso-SO 12 True True 32 Gbps 192.168.101.11



This command retrieves the network interfaces that are used by the SMB server that have the link speed of 10 gigabits or faster.





Example 3: Get network interfaces for a specific server



PS C:\\>Get-SmbServerNetworkInterface | Where-Object -Property ScopeName -Eq Contoso-FS

Scope Name Interface Index RSS Capable RDMA Capable Speed IpAddress

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

Contoso-FS 14 False False 1 Gbps 192.168.100.22

Contoso-FS 12 True True 32 Gbps 192.168.101.22

Contoso-FS 15 True True 32 Gbps 192.168.102.22



This command retrieves the network interfaces that are used by the SMB server named Contoso-FS.





Example 4: Get properties of network interfaces of an SMB server



PS C:\\>Get-SmbServerNetworkInterface | Where-Object -Property ScopeName -Eq Contoso-FS | Select-Object -Property *

FriendlyName : Internal

InterfaceIndex : 14

IpAddress : 192.168.100.22

LinkSpeed : 1000000000

RdmaCapable : False

RssCapable : False

ScopeName : Contoso-FS

PSComputerName :

CimClass : ROOT/Microsoft/Windows/SMB:MSFT_SmbServerNetworkInterface

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

CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties



FriendlyName : RDMA1

InterfaceIndex : 12

IpAddress : 192.168.101.22

LinkSpeed : 32000000000

RdmaCapable : True

RssCapable : True

ScopeName : Contoso-FS

PSComputerName :

CimClass : ROOT/Microsoft/Windows/SMB:MSFT_SmbServerNetworkInterface

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

CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties



FriendlyName : RDMA2

InterfaceIndex : 15

IpAddress : 192.168.102.22

LinkSpeed : 32000000000

RdmaCapable : True

RssCapable : True

ScopeName : Contoso-FS

PSComputerName :

CimClass : ROOT/Microsoft/Windows/SMB:MSFT_SmbServerNetworkInterface

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

CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties



This command retrieves all properties of the network interfaces that are used by the SMB server named Contoso-FS.







RELATED LINKS

Get-SmbClientNetworkInterface