Remove-VMSwitchExtensionPortFeature

Remove-VMSwitchExtensionPortFeature

Removes a feature from a virtual network adapter.

構文

Parameter Set: VMName
Remove-VMSwitchExtensionPortFeature -VMSwitchExtensionFeature <Microsoft.HyperV.PowerShell.VMSwitchExtensionPortFeature[]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-ExternalPort] [-ManagementOS] [-Passthru] [-SwitchName <System.String> ] [-VM <Microsoft.HyperV.PowerShell.VirtualMachine[]> ] [-VMName <String[]> ] [-VMNetworkAdapter <Microsoft.HyperV.PowerShell.VMNetworkAdapterBase[]> ] [-VMNetworkAdapterName <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Remove-VMSwitchExtensionPortFeature cmdlet removes a feature from a virtual network adapter. The feature must have already been configured on the virtual network adapter.

パラメーター

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

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

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-ComputerName<System.String[]>

Specifies one or more Hyper-V hosts that run this cmdlet. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-ExternalPort

Specifies the external port on the virtual switch that binds to a physical network adapter.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-ManagementOS

Specifies that the feature is to be removed from the management (e.g. the parent, or host) operating system.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Passthru

Specifies that a Microsoft.HyperV.PowerShell.VMSwitchExtensionPortFeature is to be passed through to the pipeline representing the feature to be removed.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-SwitchName<System.String>

Specifies the name of the virtual switch from which the feature is to be removed.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-VM<Microsoft.HyperV.PowerShell.VirtualMachine[]>

Specifies the virtual machine from which the feature is to be removed.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-VMName<String[]>

Specifies the name of the virtual machine from which the feature is to be removed.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-VMNetworkAdapter<Microsoft.HyperV.PowerShell.VMNetworkAdapterBase[]>

Specifies the virtual machine network adapter from which the feature is to be removed.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-VMNetworkAdapterName<System.String>

Specifies the name of the virtual network adapter from which the feature is to be removed.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-VMSwitchExtensionFeature<Microsoft.HyperV.PowerShell.VMSwitchExtensionPortFeature[]>

Specifies the feature to be removed.

Aliases

none

必須/オプション

true

位置

named

既定値

none

パイプライン入力の受け入れ

true(ByValue)

ワイルドカード文字の受け入れ

false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション

false

位置

named

既定値

false

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション

false

位置

named

既定値

false

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

<CommonParameters>

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

入力

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

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

  • None by default; Microsoft.HyperV.PowerShell.VMSwitchExtensionPortFeature if –PassThru is specified.

使用例

Example 1

Removes a feature configured on the virtual network adapter(s) on a virtual machine.

PS C:\> $feature = Get-VMSwitchExtensionPortFeature -VMName VM2 -FeatureId 776e0ba7-94a1-41c8-8f28-951f524251b5
PS C:\> Remove-VMSwitchExtensionPortFeature VM2 -VMSwitchExtensionFeature $feature