.png)
Get-SmbServerNetworkInterface
Updated: August 15, 2012
Applies To: Windows Server 2012
Get-SmbServerNetworkInterface
Syntax
Parameter Set: __AllParameterSets Get-SmbServerNetworkInterface [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Detailed Description
The Get-SmbServerNetworkInterface cmdlet retrieves the network interfaces used by the Server Message Block (SMB) server.
Parameters
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. The cmdlet immediately returns an object that represents the job and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the *-Job cmdlets. To get the job results, use the Receive-Job cmdlet. For more information about Windows PowerShell® background jobs, see about_Jobs.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-CimSession<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.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-ThrottleLimit<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.
|
Aliases |
none |
|
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, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- None
Outputs
The output type is the type of the objects that the cmdlet emits.
-
Microsoft.Management.Infrastructure.CimInstance#root/Microsoft/Windows/SMB/MSFT_SmbServerNetworkInterface
The MSFT_SmbServerNetworkInterface object represents the network interfaces of the SMB server.
Examples
EXAMPLE 1
This example retrieves the network interfaces used by the SMB server.
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
EXAMPLE 2
This example retrieves the network interfaces used by the SMB server with the link speed of 10 gigabits or faster.
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
EXAMPLE 3
This example retrieves the network interfaces used by the SMB server named Contoso-FS.
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
EXAMPLE 4
This example retrieves all of the network interfaces used by the SMB server named Contoso-FS.
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
Related topics
