New-SCDCBSettings

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 $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

-ClusterHeartbeatBandwidth

-ClusterHeartbeatPriority

-HostNetworkAdapters

-RemoveDCBSettings

-SMBBandwidth

-SMBPriority

-VirtualNetworkAdapters

-VMMServer

Outputs

DCBSettings

This cmdlet returns a DCBSettings object.