Set-NetAdapterVmq

Set-NetAdapterVmq

Sets the virtual machine queue (VMQ) properties of the network adapter.

構文

Parameter Set: ByName
Set-NetAdapterVmq [-Name] <String[]> [-AsJob] [-BaseProcessorGroup <UInt16> ] [-BaseProcessorNumber <Byte> ] [-CimSession <CimSession[]> ] [-Enabled <Boolean> ] [-IncludeHidden] [-MaxProcessorNumber <Byte> ] [-MaxProcessors <UInt32> ] [-NoRestart] [-NumaNode <UInt16> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByInstanceID
Set-NetAdapterVmq -InterfaceDescription <String[]> [-AsJob] [-BaseProcessorGroup <UInt16> ] [-BaseProcessorNumber <Byte> ] [-CimSession <CimSession[]> ] [-Enabled <Boolean> ] [-IncludeHidden] [-MaxProcessorNumber <Byte> ] [-MaxProcessors <UInt32> ] [-NoRestart] [-NumaNode <UInt16> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Set-NetAdapterVmq -InputObject <CimInstance[]> [-AsJob] [-BaseProcessorGroup <UInt16> ] [-BaseProcessorNumber <Byte> ] [-CimSession <CimSession[]> ] [-Enabled <Boolean> ] [-MaxProcessorNumber <Byte> ] [-MaxProcessors <UInt32> ] [-NoRestart] [-NumaNode <UInt16> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-NetAdapterVmq cmdlet sets the virtual machine queue (VMQ) properties of the network adapter. VMQ is a scaling networking technology for Hyper-V switch that improves network throughput by distributing processing of network traffic for multiple virtual machines (VMs) among multiple processors. A thorough familiarity with VMQ and dynamic VMQ is highly recommended before changing any default values with this cmdlet.

パラメーター

-AsJob

-BaseProcessorGroup<UInt16>

Specifies the processor group to be used by VMQ. Support for systems that have more than 64 logical processors is based on the concept of a processor group, which is a static set of up to 64 logical processors. Processor groups are numbered starting with 0. Computers with fewer than 64 logical processors always have a single group, Group 0.

-BaseProcessorNumber<Byte>

Specifies the starting processor to be used within the processor group for VMQ. Support for systems that have more than 64 logical processors is based on the concept of a processor group, which is a static set of up to 64 logical processors. Processor groups are numbered starting with 0. Computers with fewer than 64 logical processors always have a single group, Group 0. A logical processor is identified by a group number, using the BaseProcessorGroup parameter, and a group-relative processor number, using this parameter.

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-Enabled<Boolean>

Sets the enabled state of VMQ. このパラメーターに対して使用できる値: $true or $false.

-IncludeHidden

Specifies both visible and hidden network adapters should be included. By default only visible network adapters are included. If a wildcard character is used in identifying a network adapter and this parameter has been specified, then the wildcard string is matched against both hidden and visible network adapters.

-InputObject<CimInstance[]>

このコマンドレットへの入力を指定します。このパラメーターを使用するか、パイプを使用して入力をこのコマンドレットに渡すことができます。

-InterfaceDescription<String[]>

Specifies the network adapter interface description. For a physical network adapter this is typically the name of the vendor of the network adapter followed by a part number and description, such as Contoso 12345 Gigabit Network Device.

-MaxProcessorNumber<Byte>

Specifies the largest processor number in the group.

-MaxProcessors<UInt32>

Specifies the maximum number of processors used by VMQ for load balancing network transmissions.

-Name<String[]>

Specifies the name of the network adapter.

-NoRestart

Specifies that the network adapter is not restarted as part of running this cmdlet. Note: Many advanced properties require restarting the network adapter before the new settings take effect.

-NumaNode<UInt16>

Specifies the preferred non-uniform memory access (NUMA) node for the affinity of the VMQs allocated on this network adapter.

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_NetAdapterVmqSettingData[]

  Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) の後のパスは、基になる WMI オブジェクトの名前空間とクラス名です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_NetAdapterVmqSettingData

  Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) の後のパスは、基になる WMI オブジェクトの名前空間とクラス名です。

例

EXAMPLE 1

This example enables VMQ on the network adapter named MyAdapter. Note: The Enable-NetAdapterVmq cmdlet is the preferred cmdlet to perform this operation.

PS C:\> Set-NetAdapterVmq –Name MyAdapter -Enabled $True

関連トピック

Disable-NetAdapterVmq

Enable-NetAdapterVmq

Get-NetAdapterVmq

Get-NetAdapterVmqQueue