Set-SCMACAddressPool

Modifies a MAC address pool.

Description

The Set-SCMACAddressPool cmdlet modifies a System Center Virtual Machine Manager (VMM) 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.

For more information about Set-SCMACAddressPool, type: "Get-Help Set-SCMACAddressPool -online".

Parameters

MACAddressPool

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a MAC address pool.

AddVMHostGroup

Required? false
Accept Pipeline Input? false
Position? named 
Adds one or more host groups to an existing host group array or private cloud.

Description

Required? false
Accept Pipeline Input? false
Position? named 
States a description for the specified object.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

MACAddressRangeEnd

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the last address in a range of static MAC addresses.

MACAddressRangeStart

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the first address in a range of static MAC addresses.

Name

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the name of a VMM object.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RemoveVMHostGroup

Required? false
Accept Pipeline Input? false
Position? named 
Removes one or more host groups from a host group array or private cloud.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

Examples

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 "All Hosts\HostGroup03\Production" in addition to the host groups it was previously associated with.

See Also