Edit

Set-NetQosDcbxSetting

  • Reference
Module:
DcbQoS

Sets the data center bridging exchange (DCBX) settings.

Syntax

Set-NetQosDcbxSetting
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-NetQosDcbxSetting
   [-InputObject <CimInstance[]>]
   -Willing <Boolean>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-NetQosDcbxSetting cmdlet sets the data center bridging exchange (DCBX) settings. The only setting that Windows Server® 2012 and later allows a user to set is that the network adapters in computers running Windows Server 2012 and later should accept data center bridging (DCB) configurations from Windows Server 2012 and later or from a remote device via the DCBX protocol, which is specified in the IEEE data center bridging (DCB) standard.

If the Willing parameter is set to True, then Windows Server 2012 or later will not send priority-based flow control (PFC) and traffic class settings to DCB-capable network adapters in the computer. If the Willing parameter is set to False, then Windows Server 2012 or later will send the settings to the network adapters.

Examples

EXAMPLE 1

PS C:\> Set-NetQosDcbxSetting -Willing $true

This example enables the DCBX willing state, so that a DCB-capable network adapter is willing to accept configurations from a remote peer.

Parameters

-AsJob

ps_cimcommon_asjob

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-InputObject

Specified the object which will be modified by this cmdlet. The object must be piped to the cmdlet.

Type:CimInstance[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

-Willing

Specifies that a DCB-capable network adapter should accept the configuration from a remote peer via the DCBX protocol.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

None

Outputs

CimInstance

The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The path after the pound sign (#) provides the namespace and class name for the underlying WMI object.

The MSFT_NetQosDcbxSettingData object contains the DCBX setting configured in Windows Server 2012 and later. Only when the PassThru parameter is specified will the command return the MSFT_NetQosDcbxSettingData object.

CimInstance

The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The path after the pound sign (#) provides the namespace and class name for the underlying WMI object.