Grant-SCMACAddress

MAC アドレス プールから次に使用可能な物理アドレス (MAC アドレス) を割り当て、仮想ネットワーク アダプターに割り当てます。

構文

Grant-SCMACAddress
     [-VMMServer <ServerConnection>]
     [-MACAddress <String>]
     -MACAddressPool <MACAddressPool>
     -VirtualNetworkAdapter <VirtualNetworkAdapter>
     [-Description <String>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Grant-SCMACAddress コマンドレットは、MAC アドレス プールからメディア Access Control (MAC) アドレスとして指定された次の使用可能な物理アドレスを割り当て、仮想ネットワーク アダプターに割り当てます。 特定の MAC アドレスを割り当てるには、 MACAddress パラメーターを使用します。

MAC アドレス プールの作成については、次のように入力します New-SCMACAddressPool -Detailed

例 1: MAC アドレス プールから MAC アドレスを割り当て、仮想ネットワーク アダプターに割り当てる

PS C:\> $VM = Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com" -Name "VM01"
PS C:\> $VNIC = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $MACAddressPool = Get-SCMACAddressPool -VMHostGroup $HostGroup -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACAddressPool -VirtualNetworkAdapter $VNIC

最初のコマンドは、ホスト VMHost01 上の VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、$VMに格納されている仮想マシンの仮想ネットワーク アダプター オブジェクトを取得し、$VNIC変数にオブジェクトを格納します。 この例では、仮想マシンに仮想ネットワーク アダプターが 1 つしかないことを前提としています。

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

4 番目のコマンドは、$HostGroupに格納され、名前付き MAC アドレス プール 01 に格納されているホスト グループに関連付けられている MAC アドレス プールを取得します。

最後のコマンドは、$VNICに格納されている仮想ネットワーク アダプターに MAC アドレスを割り当てます。

例 2: MAC アドレス プールから MAC アドレスを割り当て、特定の仮想ネットワーク アダプターに割り当てる

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VNIC = Get-SCVirtualNetworkAdapter -VM $VM | where {$_.SlotId -eq 1}
PS C:\> $MACAddressPool = Get-SCMACAddressPool -Name "MAC Address Pool 02"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACAddressPool -VirtualNetworkAdapter $VNIC

最初のコマンドは、VM02 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、スロット ID が 1 の VM02 の仮想ネットワーク アダプター オブジェクトを取得し、そのオブジェクトを $VNIC 変数に格納します。

3 番目のコマンドは、MAC アドレス プール 02 という名前の MAC アドレス プールを取得し、$MACAddressPool変数にオブジェクトを格納します。

最後のコマンドは、MAC アドレス プール 02 から、$VNICに格納されている仮想ネットワーク アダプターに MAC アドレスを付与します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-Description

MAC アドレスの説明を指定します。

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

-JobVariable

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

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

-MACAddress

コンピューター上の物理または仮想ネットワーク アダプターの MAC アドレスまたは MAC アドレスのセットを指定します。

  • 1 つの MAC アドレスの形式の例: -MACAddress "00-15-5D-B4-DC-00"
  • 一連の MAC アドレスの形式の例: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressPool

MAC アドレス プールを指定します。

Type:MACAddressPool
Position:Named
Default value:None
Required:True
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

-RunAsynchronously

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

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

-VirtualNetworkAdapter

仮想マシンの仮想ネットワーク アダプター オブジェクトを指定します。

仮想ネットワーク アダプターの最大数は、ホストの種類によって異なります。 ホストの種類が Hyper-V の場合、仮想ネットワーク アダプターの最大数は次のようになります。

  • 仮想マシンあたり最大 4 つのエミュレートされたアダプター。
  • 仮想マシンあたり最大 8 つの合成アダプター。 例外として、Windows Server 2003 x64 ゲストでエミュレートされたネットワーク アダプターにドライバーを使用できないことがあります。

ホストの種類が VMware ESX の場合:

  • 仮想マシンあたり最大 4 つのエミュレートされたアダプター。

ホストの種類が Citrix XenServer の場合:

  • 仮想マシンあたり最大 7 つのエミュレートされたアダプター。
Type:VirtualNetworkAdapter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

VMM (Virtual Machine Manager) サーバー オブジェクトを指定します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

出力

CloudPairing[]

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

メモ

  • Get-SCMACAddressPool コマンドレットを使用して取得できる VMM MACAddressPool オブジェクトと、 Get-SCVirtualNetworkAdapter コマンドレットを使用して取得できる VMM 仮想ネットワーク アダプター オブジェクトが必要です。