New-SCDCBSettings
Note: This cmdlet is applicable for VMM 2019 UR1.
Configures DCB settings in the S2D cluster managed by VMM.
Syntax
Default (Default)
New-SCDCBSettings
[-VMMServer <ServerConnection>]
[-AddDCBSettings]
[-RemoveDCBSettings]
[-HostNetworkAdapters <HostNetworkAdapter[]>]
[-VirtualNetworkAdapters <VirtualNetworkAdapter[]>]
[-SMBPriority <Int32>]
[-SMBBandwidth <Int32>]
[-ClusterHeartbeatPriority <Int32>]
[-ClusterHeartbeatBandwidth <Int32>]
[<CommonParameters>]
Description
The -New-SCDCBSettings cmdlet configures DCB settings in the S2D cluster managed by Virtual Machine Manager (VMM).
Examples
Example 1: Set DCB settings while creating HCI cluster
PS C:\> $HostNetworkAdpaters = Get-SCVMHostNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$VirtualHostNetworkAdpaters = Get-SCVirtualNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$DCBSettings = New-SCDCBSettings -AddDCBSettings -SMBPriority 3 -SMBBandwidth 50 -ClusterHeartbeatPriority 7 -ClusterHeartbeatBandwidth 1 -HostNetworkAdapters $HostNetworkAdpaters -VirtualNetworkAdapters $VirtualHostNetworkAdpaters
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "New York"
PS C:\> $Nodes = Get-SCVMHost | where {$_.Name -like "HostClus*" -and $_.VMHostGroup -eq $HostGroup}
PS C:\> Install-SCVMHostCluster -VMHost $Nodes -ClusterName "Cluster01" -Credential $RunAsAcct -EnableS2D -DCBSettings $DCBSettings
The first two commands are used to fetch the HostNetworkAdapters and HostVirtualNetworkAdapters.
The third command is used to create a DCB settings object.
The fourth command gets the Run As account named RunAsAccount01 and stores it in the $RunAsAcct variable.
The fifth command gets the host group object named New York and stores the object in the $HostGroup variable.
The sixth command gets the cluster nodes that begin with the name HostClus in the host group stored in $HostGroup. The command then stores the nodes in the $Nodes variable.
The last command creates the cluster and names it Cluster01 and applies the DCB settings as per cmdlet above. Set DCB settings on a hyper converge cluster
Example 2: Set DCB settings on a hyper converge cluster
PS C:\>$HostNetworkAdpaters = Get-SCVMHostNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$VirtualHostNetworkAdpaters = Get-SCVirtualNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$DCBSettings = New-SCDCBSettings -AddDCBSettings -SMBPriority 3 -SMBBandwidth 50 -ClusterHeartbeatPriority 7 -ClusterHeartbeatBandwidth 1 -HostNetworkAdapters $HostNetworkAdpaters -VirtualNetworkAdapters $VirtualHostNetworkAdpaters
PS C:\>$cluster = Get-SCVMHostCluster where {$_.Name -like "HostClus*"}
PS C:\> Set-SCVMHostCluster -VMHostCluster $cluster -DCBSettings $DCBSettings
The first two commands are used to fetch the HostNetworkAdapters and HostVirtualNetworkAdapters.
The third command is used to create a DCB settings object.
The last command sets the DCB settings on the hyper converged cluster.
Example 3: Set DCB settings on a scale out file server S2D cluster
PS C:\>$HostNetworkAdpaters = Get-SCVMHostNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$VirtualHostNetworkAdpaters = Get-SCVirtualNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$DCBSettings = New-SCDCBSettings -AddDCBSettings -SMBPriority 3 -SMBBandwidth 50 -ClusterHeartbeatPriority 7 -ClusterHeartbeatBandwidth 1 -HostNetworkAdapters $HostNetworkAdpaters -VirtualNetworkAdapters $VirtualHostNetworkAdpaters
PS C:\>$sofs = Get-SCStorageFileServer where {$_.Name -like "SOFSClus*"}
PS C:\> Set-SCStorageFileServer-StorageFileServer $sofs -DCBSettings $DCBSettings
The first two commands are used to fetch the HostNetworkAdapters and HostVirtualNetworkAdapters.
The third command is used to create a DCB settings object.
The last command sets the DCB settings on the SOFS cluster.
Example 4: Remove DCB settings on a hyper converge cluster
PS C:\>$HostNetworkAdpaters = Get-SCVMHostNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$VirtualHostNetworkAdpaters = Get-SCVirtualNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$DCBSettings = New-SCDCBSettings -RemoveDCBSettings -HostNetworkAdapters $HostNetworkAdpaters -VirtualNetworkAdapters $VirtualHostNetworkAdpaters
PS C:\>$cluster = Get-SCVMHostCluster where {$_.Name -like "HostClus*"}
PS C:\> Set-SCVMHostCluster -VMHostCluster $cluster -DCBSettings $DCBSettings
The first two commands are used to fetch the HostNetworkAdapters and HostVirtualNetworkAdapters.
The third command is used to create a DCB settings object with RemoveDCBSettings flag.
The fourth command is to create an object that gets SCVMHostCluster details.
The last command sets the DCB settings on the hyper converged cluster.
Example 5: Remove DCB settings on a scale out file server S2D cluster
PS C:\>$HostNetworkAdpaters = Get-SCVMHostNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$VirtualHostNetworkAdpaters = Get-SCVirtualNetworkAdapter where {$_.Name -like "RDMA*"}
PS C:\>$DCBSettings = New-SCDCBSettings -RemoveDCBSettings -HostNetworkAdapters $HostNetworkAdpaters -VirtualNetworkAdapters $VirtualHostNetworkAdpaters
PS C:\>$sofs = Get-SCStorageFileServer where {$_.Name -like "SOFSClus*"}
PS C:\> Set-SCStorageFileServer-StorageFileServer $sofs -DCBSettings $DCBSettings
The first two commands are used to fetch the HostNetworkAdapters and HostVirtualNetworkAdapters.
The third command is used to create a DCB settings object with RemoveDCBSettings flag.
The fourth command is to create an object that gets CStorageFileServer details.
The last command sets the DCB settings on the SOFS S2D cluster.
Parameters
-AddDCBSettings
Enable this flag to add DCB settings.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ClusterHeartbeatBandwidth
Specifies the bandwidth of cluster Heartbeat traffic.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ClusterHeartbeatPriority
Specifies the priority of cluster Heartbeat traffic.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HostNetworkAdapters
Specify the host Network adapters on which you want to apply DCB settings.
Parameter properties
| Type: | HostNetworkAdapter[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RemoveDCBSettings
Enable this flag to remove DCB settings.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SMBBandwidth
Specifies Bandwidth for SMB traffic.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SMBPriority
Specifies priority of SMB traffic.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VirtualNetworkAdapters
Specify the host virtual Network adapters on which you want to apply DCB settings.
Parameter properties
| Type: | VirtualNetworkAdapter[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VMMServer
Specifies a VMM server object.
Parameter properties
| Type: | ServerConnection |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Outputs
DCBSettings
This cmdlet returns a DCBSettings object.