Get-SCMACAddress

Gets allocated MAC addresses.

Description

The Get-SCMACAddress cmdlet gets allocated MAC addresses.

For more information about Get-SCMACAddress, type: "Get-SCMACAddress -online".

Parameters

All

Required? false
Accept Pipeline Input? false
Position? named
Retrieves a full list of all subordinate objects independent of the parent object. For example, the command Get-SCVirtualDiskDrive -All retrieves all virtual disk drive objects regardless of the virtual machine object or template object that each virtual disk drive object is associated with.

Assigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool and assigned to a resource.

UnAssigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool but not assigned to a resource.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

GrantToObjectID

Required? true
Accept Pipeline Input? false
Position? named
Specifies the ID of an object to which an allocated IP address or MAC address will be assigned.

Assigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool and assigned to a resource.

UnAssigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool but not assigned to a resource.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

ID

Required? true
Accept Pipeline Input? false
Position? named
Specifies the numerical identifier (as a globally unique identifier, or GUID) for a specific object.

Assigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool and assigned to a resource.

UnAssigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool but not assigned to a resource.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

MACAddress

Required? true
Accept Pipeline Input? false
Position? named
Specifies the Media Access Control (MAC) address, or a set of MAC addresses, for a physical or virtual network adapter on a computer. Valid values are: one or more MAC addresses.

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

Example format for a set of MAC addresses:
  -MACAddress “00-15-5D-B4-DC-00”, “00-1A-A0-E3-75-29”

Example format for a set of MAC addresses:
  $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

Assigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool and assigned to a resource.

UnAssigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool but not assigned to a resource.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

MACAddressPool

Required? true
Accept Pipeline Input? false
Position? named
Specifies a MAC address pool.

Assigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool and assigned to a resource.

UnAssigned

Required? false
Accept Pipeline Input? false
Position? named
Retrieves IP addresses or MAC addresses that have been allocated from an address pool but not assigned to a resource.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

Examples

1: Get the allocated MAC addresses for a specific MAC address pool.
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> Set-SCVMHostGroup -VMHostGroup $HostGroup -InheritNetworkSettings $False
PS C:\> $MACAddressPool = @(Get-SCMACAddressPool -VMHostGroup $HostGroup)
PS C:\> Get-SCMACAddress -MACAddressPool $MACAddressPool[0]
The first command gets the host group object at the path "All Hosts\HostGroup02\Production" and stores the object in the $HostGroup variable.

The second command disables inheritance of network settings for the host group stored in $HostGroup. This action returns only the MAC address pools associated with All Hosts\HostGroup02\Production in the next command. Otherwise, all MAC address pools inherited by this host group are also returned.

The thrid command gets the MAC address pool objects associated with the host group stored in $HostGroup and stores the objects in the $MACAddressPool array.

The last command gets the allocated MAC addresses for the first MAC address pool in $MACAddressPool.

See Also