Get-SCMACAddress
Get-SCMACAddress
Gets allocated MAC addresses.
Syntax
Parameter Set: All
Get-SCMACAddress [-All] [-Assigned] [-UnAssigned] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Parameter Set: ByAllocatedToObjectID
Get-SCMACAddress -GrantToObjectID <Guid> [-Assigned] [-UnAssigned] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Parameter Set: ByID
Get-SCMACAddress -ID <Guid> [-Assigned] [-UnAssigned] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Parameter Set: ByMACAddress
Get-SCMACAddress -MACAddress <String> [-Assigned] [-UnAssigned] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Parameter Set: ByPool
Get-SCMACAddress -MACAddressPool <MACAddressPool> [-Assigned] [-UnAssigned] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The Get-SCMACAddress cmdlet gets allocated MAC addresses.
Parameters
-All
Indicates that this cmdlet 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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Assigned
Indicates that this cmdlet retrieves IP addresses or MAC addresses that have been allocated from an address pool and assigned to a resource.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-GrantToObjectID<Guid>
Specifies the ID of an object to which an allocated IP address or MAC address will be assigned.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ID<Guid>
Specifies the numerical identifier as a globally unique identifier (GUID) for a specific object.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-MACAddress<String>
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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-MACAddressPool<MACAddressPool>
Specifies a MAC address pool.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-UnAssigned
Indicates that this cmdlet retrieves IP addresses or MAC addresses that have been allocated from an address pool but not assigned to a resource.
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.
- CloudPairing[]
Examples
Example 1: Get the allocated MAC addresses for a specific MAC address pool
The first command gets the host group object at the path All Hosts\HostGroup02\Production, and then 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 third command gets the MAC address pool objects associated with the host group stored in $HostGroup, and then stores the objects in the $MACAddressPool array.
The last command gets the allocated MAC addresses for the first MAC address pool in $MACAddressPool.
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]