New-SCDCBSettings
Note: This cmdlet is applicable for VMM 2019 UR1 and later.
Configures DCB settings in the S2D cluster managed by VMM.
Syntax
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 $DCBSettingsThe 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 $DCBSettingsThe 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 $DCBSettingsThe 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 $DCBSettingsThe 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 $DCBSettingsThe 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClusterHeartbeatBandwidth
Specifies the bandwidth of cluster Heartbeat traffic.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClusterHeartbeatPriority
Specifies the priority of cluster Heartbeat traffic.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostNetworkAdapters
Specify the host Network adapters on which you want to apply DCB settings.
| Type: | HostNetworkAdapter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveDCBSettings
Enable this flag to remove DCB settings.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBBandwidth
Specifies Bandwidth for SMB traffic.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBPriority
Specifies priority of SMB traffic.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetworkAdapters
Specify the host virtual Network adapters on which you want to apply DCB settings.
| Type: | VirtualNetworkAdapter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Specifies a VMM server object.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Outputs
DCBSettings
This cmdlet returns a DCBSettings object.