< Back
New-VMHostProfileVmPortGroupConfiguration
Post
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
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