learn.microsoft.com Open in urlscan Pro
104.87.108.76  Public Scan

Form analysis
0 forms found in the DOM

Text Content

Skip to main content


This browser is no longer supported.

Upgrade to Microsoft Edge to take advantage of the latest features, security
updates and technical support.

Download Microsoft Edge More info about Internet Explorer and Microsoft Edge

Table of contents Exit focus mode

Read in English Save
Table of contents Read in English Save Edit

Twitter LinkedIn Facebook Email
Table of contents


NEW-SMBMULTICHANNELCONSTRAINT

 * Reference

Feedback
Module: SmbShare

Creates a new Server Message Block (SMB) multi-channel constraint for the
specified server.


IN THIS ARTICLE


SYNTAX

New-SmbMultichannelConstraint
   [-ServerName] <String>
   [-InterfaceIndex] <UInt32[]>
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Force]
   [-ThrottleLimit <Int32>]
   [-Confirm]
   [-WhatIf]

New-SmbMultichannelConstraint
   [-ServerName] <String>
   [-InterfaceAlias] <String[]>
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-Force]
   [-ThrottleLimit <Int32>]
   [-Confirm]
   [-WhatIf]


DESCRIPTION

The New-SmbMultichannelConstraint cmdlet creates a new Server Message Block
(SMB) multi-channel constraint for the specified server.


EXAMPLES


EXAMPLE 1

PS C:\>New-SmbMultichannelConstraint -ServerName Contoso-SO -InterfaceAlias RDMA1, RDMA2
Confirm 
Are you sure you want to perform this action? 
Performing operation 'New-SmbMultichannelConstraint' on Target 'Contoso-SO'. 
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y 
 
InterfaceAlias : RDMA1 
InterfaceGuid  : {597b0a73-2b66-4be0-9e6d-f42eae8a35d6} 
InterfaceIndex : 12 
ServerName     : Contoso-SO 
PSComputerName : 
 
InterfaceAlias : RDMA2 
InterfaceGuid  : {bd3c4a04-64cf-4205-88f5-38c4c35dfc38} 
InterfaceIndex : 15 
ServerName     : Contoso-SO 
PSComputerName :

This example creates a new SMB multi-channel constraint for the SMB server named
Contoso-SO.


EXAMPLE 2

PS C:\>New-SmbMultichannelConstraint -ServerName Contoso-SO -InterfaceIndex 12, 15 -Force

InterfaceAlias : RDMA1 
InterfaceGuid  : {597b0a73-2b66-4be0-9e6d-f42eae8a35d6} 
InterfaceIndex : 12 
ServerName     : Contoso-SO 
PSComputerName : 
 
InterfaceAlias : RDMA2 
InterfaceGuid  : {bd3c4a04-64cf-4205-88f5-38c4c35dfc38} 
InterfaceIndex : 15 
ServerName     : Contoso-SO 
PSComputerName :

This example creates a new SMB multi-channel constraint for the SMB server named
Contoso-SO without user confirmation.


PARAMETERS


-ASJOB

ps_cimcommon_asjob

Type:SwitchParameter Position:Named Default value:None 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-CimSessionhttp://go.microsoft.com/fwlink/p/?LinkId=227967 or
Get-CimSessionhttp://go.microsoft.com/fwlink/p/?LinkId=227966 cmdlet. The
default is the current session on the local computer.

Type:CimSession[] Position:Named Default value:None Accept pipeline input:False
Accept wildcard characters:False


-CONFIRM

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter Position:Named Default value:False Accept pipeline
input:False Accept wildcard characters:False


-FORCE

Forces the command to run without asking for user confirmation.

Type:SwitchParameter Position:Named Default value:None Accept pipeline
input:False Accept wildcard characters:False


-INTERFACEALIAS

Specifies the interface aliases of the network interfaces that is used to
connect to the server.

Type:String[] Position:3 Default value:None Accept pipeline input:False Accept
wildcard characters:False


-INTERFACEINDEX

Specifies the interface indexes of the network interfaces that are used to
connect to the server.

Type:UInt32[] Position:3 Default value:None Accept pipeline input:False Accept
wildcard characters:False


-SERVERNAME

Specifies, when the SMB client is connecting to this server, that the
constraints determine which network interfaces are used.

Type:String Position:2 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 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 Accept pipeline input:False Accept
wildcard characters:False


-WHATIF

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter Position:Named Default value:False Accept pipeline
input:False Accept wildcard characters:False


INPUTS

None


OUTPUTS

CimInstance

The MSFT_SmbMultiChannelConnection object represents the SMB multi-channel
constraints for the server against which one or more constraints are created.


RELATED LINKS

 * Get-SmbMultichannelConstraint
 * Remove-SmbMultichannelConstraint






FEEDBACK

Submit and view feedback for

This product This page
View all page feedback
Theme
 * Light
 * Dark
 * High contrast

 * 
 * Previous versions
 * Blog
 * Contribute
 * Privacy
 * Terms of Use
 * Trademarks
 * © Microsoft 2022


ADDITIONAL RESOURCES






IN THIS ARTICLE



Theme
 * Light
 * Dark
 * High contrast

 * 
 * Previous versions
 * Blog
 * Contribute
 * Privacy
 * Terms of Use
 * Trademarks
 * © Microsoft 2022