Set-SCMACAddressPool

Modifies a MAC address pool.

Syntax

Set-SCMACAddressPool [-MACAddressPool] <MACAddressPool> [-AddVMHostGroup <HostGroup[]>] [-Description <String>]
 [-JobVariable <String>] [-MACAddressRangeEnd <String>] [-MACAddressRangeStart <String>] [-Name <String>]
 [-PROTipID <Guid>] [-RemoveVMHostGroup <HostGroup[]>] [-RunAsynchronously]
 [-SupportedVirtualizationPlatforms <VirtualizationPlatform[]>] [-VMMServer <ServerConnection>]
 [<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[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the address pool.

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

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

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

Specifies a MAC address pool.

Type:MACAddressPool
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-MACAddressRangeEnd

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

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

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

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

Specifies the name of a VMM object.

Type:String
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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[]
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportedVirtualizationPlatforms

Specifies one or more virtualization platform objects.

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

Specifies a VMM server object.

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

Outputs

MACAddressPool

This cmdlet returns a **MACAddressPool** object.