Share via

Set-SCMACAddressPool

  • Reference
Module:
VirtualMachineManager

Modifies a MAC address pool.

Syntax

Set-SCMACAddressPool
   [-VMMServer <ServerConnection>]
   [-MACAddressPool] <MACAddressPool>
   [-Name <String>]
   [-Description <String>]
   [-MACAddressRangeStart <String>]
   [-MACAddressRangeEnd <String>]
   [-AddVMHostGroup <HostGroup[]>]
   [-RemoveVMHostGroup <HostGroup[]>]
   [-SupportedVirtualizationPlatforms <VirtualizationPlatform[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

The Set-SCMACAddressPool cmdlet modifies a Virtual Machine Manager (VMM) Media Access Control (MAC) address pool. For example, you can add a host group to or remove a host group from a MAC address pool. A MAC address pool can be associated with one or more host groups.

Examples

Example 1: Change the host groups associated with a MAC address pool

PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01" 
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup03\Production" }
PS C:\> Set-SCMacAddressPool -MACAddressPool $MACPool -AddVMHostGroup $HostGroup

The first command gets the MAC address pool object named MAC Address Pool 01 and stores the object in the $MACPool variable.

The second command gets the host group object named All Hosts\HostGroup03\Production and stores the object the $HostGroup variable.

The last command updates adds the host group stored in $HostGroup to the MAC address pool stored in $MACPool. In this case, MAC Address Pool 01 is now also associated with the host group named All Hosts\HostGroup03\Production in addition to the host groups it was previously associated with.

Parameters

-AddVMHostGroup

Specifies an array of host groups that this cmdlet adds to an existing host group array or private cloud.

Type:HostGroup[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifies a description for the address pool.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifies a variable in which job progress is tracked and stored.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressPool

Specifies a MAC address pool.

Type:MACAddressPool
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MACAddressRangeEnd

Specifies the last address in a range of static MAC addresses.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressRangeStart

Specifies the first address in a range of static MAC addresses.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a VMM object.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveVMHostGroup

Specifies an array of host groups that this cmdlet removes from a host group array or private cloud.

Type:HostGroup[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SupportedVirtualizationPlatforms

Specifies one or more virtualization platform objects.

Type:VirtualizationPlatform[]
Accepted values:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Outputs

MACAddressPool

This cmdlet returns a MACAddressPool object.