Set-VMSwitchExtensionPortFeature
Configures a feature on a virtual network adapter.
Syntax
Set-VMSwitchExtensionPortFeature
[-VMName] <String[]>
[-ComputerName <String[]>]
[-Passthru]
[-VMNetworkAdapterName <String>]
-VMSwitchExtensionFeature <VMSwitchExtensionPortFeature[]>
[-Confirm]
[-WhatIf]
Set-VMSwitchExtensionPortFeature
[-SwitchName] <String>
[-ComputerName <String[]>]
[-Passthru]
[-ExternalPort]
-VMSwitchExtensionFeature <VMSwitchExtensionPortFeature[]>
[-Confirm]
[-WhatIf]
Set-VMSwitchExtensionPortFeature
[-ComputerName <String[]>]
[-Passthru]
[-VMNetworkAdapterName <String>]
[-ManagementOS]
-VMSwitchExtensionFeature <VMSwitchExtensionPortFeature[]>
[-Confirm]
[-WhatIf]
Set-VMSwitchExtensionPortFeature
[-VM] <VirtualMachine[]>
[-Passthru]
[-VMNetworkAdapterName <String>]
-VMSwitchExtensionFeature <VMSwitchExtensionPortFeature[]>
[-Confirm]
[-WhatIf]
Set-VMSwitchExtensionPortFeature
[-VMNetworkAdapter] <VMNetworkAdapterBase[]>
[-Passthru]
-VMSwitchExtensionFeature <VMSwitchExtensionPortFeature[]>
[-Confirm]
[-WhatIf]
Description
The Set-VMSwitchExtensionPortFeature cmdlet configures a feature on a virtual network adapter. The feature must have been configured previously on the virtual network adapter.
Examples
Example 1
PS C:\>$ModifiedFeature = Get-VMSwitchExtensionPortFeature -VMName VM2 -FeatureName "Ethernet Switch Port Security Settings"
PS C:\>$ModifiedFeature.SettingData.EnableDhcpGuard = $false
PS C:\>Set-VMSwitchExtensionPortFeature -VMName VM2 -VMSwitchExtensionFeature $ModifiedFeature
Configures the feature on a virtual network adapter(s) on virtual machine VM2.
Parameters
-ComputerName
Specifies one or more Hyper-V hosts on which a feature on a virtual network adapter is to be configured. 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.
Type: | String[] |
Position: | Named |
Default value: | . |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalPort
Specifies the virtual switch port connected to the external network interface card.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementOS
Specifies the management (e.g. parent, or host) operating system.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Passthru
Specifies that a Microsoft.HyperV.PowerShell.VMSwitchExtensionPortFeature object is to be passed through to the pipeline representing the feature to be configured.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SwitchName
Specifies the name of the virtual switch.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Specifies the virtual machine on which the feature is to be configured.
Type: | VirtualMachine[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Specifies the name of the virtual machine on which the feature is to be configured.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMNetworkAdapter
Specifies the virtual network adapter.
Type: | VMNetworkAdapterBase[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMNetworkAdapterName
Specifies the name of the virtual network adapter.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMSwitchExtensionFeature
Specifies the feature to be configured.
Type: | VMSwitchExtensionPortFeature[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Outputs
None
Default
Microsoft.HyperV.PowerShell.VMSwitchExtensionPortFeature
If -PassThru is specified.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for