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

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.