Windows PowerShell command on Get-command Get-SmbServerNetworkInterface

NAME

Get-SmbServerNetworkInterface

SYNOPSIS

Retrieves the network interfaces used by the SMB server.

SYNTAX

Get-SmbServerNetworkInterface [-CimSession ] [-ThrottleLimit

] []

DESCRIPTION

The Get-SmbServerNetworkInterface cmdlet retrieves the network interfaces that are used by the Server Message

Block (SMB) server.

PARAMETERS

-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 []

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 PowerShellr 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 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.