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 アドレス プールからメディア アクセス制御 (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
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
MAC アドレスの説明を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡して格納する変数を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | 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"
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MACAddressPool
MAC アドレス プールを指定します。
型: | MACAddressPool |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VirtualNetworkAdapter
仮想マシンの仮想ネットワーク アダプター オブジェクトを指定します。
仮想ネットワーク アダプターの最大数は、ホストの種類によって異なります。 ホストの種類が Hyper-V の場合、仮想ネットワーク アダプターの最大数は次のようになります。
- 仮想マシンあたり最大 4 つのエミュレートされたアダプター。
- 仮想マシンあたり最大 8 つの合成アダプター。 例外として、Windows Server 2003 x64 ゲストでエミュレートされたネットワーク アダプターに対してドライバーを使用できない場合があります。
ホストの種類が VMware ESX の場合:
- 仮想マシンあたり最大 4 つのエミュレートされたアダプター。
ホストの種類が Citrix XenServer の場合:
- 仮想マシンあたり最大 7 つのエミュレートされたアダプター。
型: | VirtualNetworkAdapter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM (仮想マシン マネージャー) サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
CloudPairing[]
このコマンドレットは、CloudPairing オブジェクト
メモ
- Get-SCMACAddressPool コマンドレットを使用して取得できる VMM MACAddressPool オブジェクトと、Get-SCVirtualNetworkAdapter コマンドレットを使用して取得できる VMM 仮想ネットワーク アダプター オブジェクトが必要です。