Get-SCMACAddressPool

  • Reference
Module:
VirtualMachineManager

Gets a MAC address pool.

Syntax

Get-SCMACAddressPool
   [-VMMServer <ServerConnection>]
   [-MACAddress <String>]
   [[-Name] <String>]
   [-VMHostGroup <HostGroup>]
   [-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
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:0
Default value:None
Required:False
Accept pipeline input:False
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
Accepted values:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostGroup

Specifies a virtual machine host group object.

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