Revoke-SCMACAddress
Revoke-SCMACAddress
Returns an allocated MAC address to the MAC address pool.
構文
Parameter Set: Default
Revoke-SCMACAddress [-AllocatedMACAddress] <AllocatedMACAddress> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-ReturnToPool <Boolean]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
詳細説明
The Revoke-SCMACAddress cmdlet returns an allocated MAC address to the MAC address pool.
For information about granting MAC addresses, type Get-Help Grant-SCMACAddress -detailed.
パラメーター
-AllocatedMACAddress<AllocatedMACAddress>
Specifies a Media Access Control (MAC) address that has been allocated from a MAC address pool.
エイリアス |
none |
必須? |
true |
位置は? |
1 |
既定値 |
none |
パイプライン入力を許可する |
True (ByValue) |
ワイルドカード文字を許可する |
false |
-JobVariable<String>
Specifies that job progress is tracked and stored in the variable named by this parameter.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-PROTipID<Guid]>
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ReturnToPool<Boolean]>
Indicates whether an IP address or MAC address is returned to its address pool. By default, this value is set to True.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-VMMServer<ServerConnection>
Specifies a VMM server object.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
True (ByValue) |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
- CloudPairing[]
例
Example 1: Return an allocated MAC address to the MAC address pool
The first command gets the host group object at path All Hosts\HostGroup02\Production, and then stores the object in the $HostGroup variable.
The second command gets the MAC address pools for the host group stored in $HostGroup, and then stores the objects in the $MACAddressPool array.
The third command gets the allocated MAC addresses from the first MAC address pool stored in $MACAddressPool, and then stores the objects in $MACAddress.
The last command revokes the first MAC address stored in $MACAddress.
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $MACAddressPool = Get-SCMACAddressPool -VMHostGroup $HostGroup
PS C:\> $MACAddress = Get-SCMACAddress -MACAddressPool $MACAddressPool[0]
PS C:\> Revoke-SCMACAddress $MACAddress[0]