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