Set-SCLogicalSwitch

Set-SCLogicalSwitch

Updates the properties of a logical switch.

構文

Parameter Set: WithExtensions
Set-SCLogicalSwitch [-LogicalSwitch] <LogicalSwitch> [-Description <String> ] [-EnableSriov <Boolean]> ] [-JobVariable <String> ] [-MinimumBandwidthMode <BandwidthMode]> ] [-Name <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-SwitchUplinkMode <SwitchUplinkMode]> ] [-VirtualSwitchExtensions <VirtualSwitchExtension[]> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: RemoveAllExtensions
Set-SCLogicalSwitch [-LogicalSwitch] <LogicalSwitch> -RemoveAllExtensions [-Description <String> ] [-EnableSriov <Boolean]> ] [-JobVariable <String> ] [-MinimumBandwidthMode <BandwidthMode]> ] [-Name <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-SwitchUplinkMode <SwitchUplinkMode]> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

詳細説明

The Set-SCLogicalSwitch cmdlet updates the properties of a logical switch.

パラメーター

-Description<String>

States a description for the specified object.

-EnableSriov<Boolean]>

Indicates whether single-root I/O virtualization (SR-IOV) is enabled.

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-LogicalSwitch<LogicalSwitch>

Specifies a logical switch object.

-MinimumBandwidthMode<BandwidthMode]>

Specifies the minimum bandwidth mode for the logical switch. Valid values are:

-- Default
-- Weight
-- Absolute
-- None

-Name<String>

Specifies the name of a VMM object.

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RemoveAllExtensions

Indicates that all virtual switch extensions are removed from the logical switch.

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-SwitchUplinkMode<SwitchUplinkMode]>

Specifies a switch uplink mode object.

-VirtualSwitchExtensions<VirtualSwitchExtension[]>

Specifies an array of virtual switch extension objects.

To get a virtual switch extension object, use the Get-SCVirtualSwitchExtension cmdlet.

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

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

入力

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

出力

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

例

Example 1: Change the minimum bandwidth mode for a logical switch

This command gets the logical switch object named LogicalSwitch01, then and uses the pipeline operator to pass the object to Set-SCLogicalSwitch. That cmdlet changes the minimum bandwidth mode for logical switch object to Weight.

PS C:\> Get-SCLogicalSwitch -Name "LogicalSwitch01" | Set-SCLogicalSwitch -MinimumBandwidthMode "Weight"

Example 2: Remove all virtual switch extensions from a logical switch

This command gets the logical switch object named LogicalSwitch01, and then uses the pipeline operator to pass the object to Set-SCLogicalSwitch. That cmdlet removes all virtual switch extensions from the logical switch object.

PS C:\> Get-SCLogicalSwitch -Name "LogicalSwitch01" | Set-SCLogicalSwitch -RemoveAllExtensions

関連トピック

Get-SCLogicalSwitch

Get-SCVirtualSwitchExtension

New-SCLogicalSwitch

Remove-SCLogicalSwitch