Get-SCMACAddressPool

Gets a MAC address pool.

Syntax

Get-SCMACAddressPool [[-Name] <String>] [-MACAddress <String>] [-VMHostGroup <HostGroup>]
 [-VMMServer <ServerConnection>] [-VirtualizationPlatform <VirtualizationPlatform>] [<CommonParameters>]

Description

The Get-SCMACAddressPool cmdlet gets one or more (Media Access Control) MAC address pools. A MAC address pool can be associated with one or more Virtual Machine Manager (VMM) host groups.

Examples

Example 1: Get all MAC address pools for a host group

PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> Get-SCMACAddressPool -VMHostGroup $HostGroup

The first command gets the host group named Production and stores it in the $HostGroup variable.

The second command gets all MAC address pools for the host group stored in $HostGroup (including its parent host group if inheritance is enabled).

Parameters

-MACAddress

Specifies the MAC address or a set of MAC addresses for a physical or virtual network adapter on a computer.

- Example format for a single MAC address: -MACAddress "00-15-5D-B4-DC-00"

  • Example formats for a set of MAC addresses: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29" $Macs = "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

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:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMHostGroup

Specifies a virtual machine host group object.

Type:HostGroup
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
-VirtualizationPlatform

Specifies the virtualization platform of a virtual machine host managed by VMM. The acceptable values for this parameter are:

- HyperV

  • VMwareESX
  • XENServer

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

Outputs

MACAddressPool

This cmdlet returns a **MACAddressPool** object.