< Back

New-VMHostProfileVmPortGroupConfiguration

Sun Jan 19, 2020 7:02 pm

NAME New-VMHostProfileVmPortGroupConfiguration



SYNOPSIS

This cmdlet creates a new virtual machine port group configuration.





SYNTAX

New-VMHostProfileVmPortGroupConfiguration [-HostProfile] <VMHostProfile> [-PortGroupName] <String> [-VSwitchName]

<String> [-Server <VIServer[]>] [-VLanId <Int32>] [<CommonParameters>]





DESCRIPTION

This cmdlet creates a new virtual machine port group configuration.





PARAMETERS

-HostProfile <VMHostProfile>

Specifies the virtual machine host profile.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-PortGroupName <String>

Specifies the name of the new virtual machine port group configuration. This name is unique for the particual

host profile.



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Server <VIServer[]>

Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this

parameter, the command runs on the default servers. For more information about default servers, see the

description of the Connect-VIServer cmdlet.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-VLanId <Int32>

Specifies the VLAN ID for the new configuration.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-VSwitchName <String>

Specifies the virtual switch name for the new configuration.



Required? true

Position? 2

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

VMware.VimAutomation.ViCore.Types.V1.Host.Profile.VMHostProfile





VMware.VimAutomation.ViCore.Types.V1.VIServer[]







OUTPUTS

VMware.VimAutomation.ViCore.Types.V1.Host.Profile.VMHostProfileVmPortGroupConfiguration







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> New-VMHostProfileVmPortGroupConfiguration -HostProfile 'Host Profile' -PortGroupName 'VM Network2'

-VSwitchName 'vSwitch0' -VLanId 1



Creates a new virtual machine port group configuration 'VM Network2' within the host profile named 'HostProfile'

with a virtual switch named 'vSwitch0' and VLAN Id that is equal to one.



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... ofile.html

Get-VMHostProfileVmPortGroupConfiguration

Set-VMHostProfileVmPortGroupConfiguration

Remove-VMHostProfileVmPortGroupConfiguration