Share via

Get-SCMACAddressPool

Module:
VirtualMachineManager Module

Gets a MAC address pool.

Syntax

Default (Default) 

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"

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of a VMM object.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualizationPlatform

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

  • HyperV
  • VMwareESX
  • XENServer

Parameter properties

Type:VirtualizationPlatform
Default value:None
Accepted values:Unknown, VirtualServer, HyperV, VMwareVC, VMwareESX, XENServer
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMHostGroup

Specifies a virtual machine host group object.

Parameter properties

Type:HostGroup
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMMServer

Specifies a VMM server object.

Parameter properties

Type:ServerConnection
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

MACAddressPool

This cmdlet returns a MACAddressPool object.