Revoke-SCMACAddress

  • リファレンス
モジュール:
VirtualMachineManager

割り当てられた MAC アドレスを MAC アドレス プールに返します。

構文

Revoke-SCMACAddress
      [-VMMServer <ServerConnection>]
      [-AllocatedMACAddress] <AllocatedMACAddress>
      [-ReturnToPool <Boolean>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [<CommonParameters>]

説明

Revoke-SCMACAddress コマンドレットは、割り当てられた MAC (メディア Access Control) アドレスを MAC アドレス プールに返します。

MAC アドレスの付与については、次のように入力します Get-Help Grant-SCMACAddress -Detailed。

例

例 1: 割り当てられた MAC アドレスを MAC アドレス プールに返す

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]

最初のコマンドは、パス "All Hosts\HostGroup02\Production" にあるホスト グループ オブジェクトを取得し、そのオブジェクトを $HostGroup 変数に格納します。

2 つ目のコマンドは、$HostGroupに格納されているホスト グループの MAC アドレス プールを取得し、$MACAddressPool配列にオブジェクトを格納します。

3 番目のコマンドは、$MACAddressPoolに格納されている最初の MAC アドレス プールから割り当てられた MAC アドレスを取得し、$MACAddressにオブジェクトを格納します。

最後のコマンドは、$MACAddressに格納されている最初の MAC アドレスを取り消します。

パラメーター

-AllocatedMACAddress

MAC アドレス プールから割り当てられた MAC アドレスを指定します。

Type:AllocatedMACAddress
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して格納する変数を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReturnToPool

IP アドレスまたは MAC アドレスがアドレス プールに返されるかどうかを示します。 既定では、この値は $True に設定されます。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

仮想マシン マネージャー (VMM) サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

CloudPairing[]

このコマンドレットは、 CloudPairing オブジェクトの配列を返します。