Get-SCMACAddressPool

Get-SCMACAddressPool

Gets a MAC address pool.

Syntax

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

Detailed Description

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

Parameters

-MACAddress<String>

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"

Set-SCPXEServer –MACAddress $Macs

NOTE: When used with New-SCPXEServer or Set-SCPXEServer, the MACAddress parameter updates the PXE interfaces from which the SCDM PXE Server listens for and responds to PXE requests.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a VMM object.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualizationPlatform<VirtualizationPlatform]>

Specifies the virtualization platform of a virtual machine host managed by VMM. Valid values are:

-- HyperV
-- VMwareESX
-- XENServer

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMHostGroup<HostGroup>

Specifies a virtual machine host group object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • MACAddressPool

Examples

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

The first command gets the host group named Production, and then 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.

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

New-SCMACAddressPool

Remove-SCMACAddressPool

Set-SCMACAddressPool