Get-SmbServerNetworkInterface
Retrieves the network interfaces used by the SMB server.
Syntax
Get-SmbServerNetworkInterface
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>] Description
The Get-SmbServerNetworkInterface cmdlet retrieves the network interfaces that are used by the Server Message Block (SMB) server.
Examples
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.8This 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.11This 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.22This 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.CimSystemPropertiesThis command retrieves all properties of the network interfaces that are used by the SMB server named Contoso-FS.
Parameters
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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.
| Type: | CimSession[] |
| Aliases: | Session |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
The MSFT_SmbServerNetworkInterface object represents the network interfaces of the SMB server.