New-SCLogicalSwitchVirtualNetworkAdapter
仮想ネットワーク アダプター (VNIC) を論理スイッチに追加します。
構文
New-SCLogicalSwitchVirtualNetworkAdapter
-UplinkPortProfileSet <UplinkPortProfileSet>
[-EthernetAddressType <EthernetAddressType>]
[-IPv4AddressType <EthernetAddressType>]
[-IPv6AddressType <EthernetAddressType>]
[-VMNetwork <VMNetwork>]
[-VMSubnet <VMSubnet>]
[-PortClassification <PortClassification>]
[-VLanEnabled <Boolean>]
[-VLanID <UInt16>]
[-IPv4AddressPool <StaticIPAddressPool>]
[-IPv6AddressPool <StaticIPAddressPool>]
[-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
[-IsUsedForHostManagement <Boolean>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[[-Description] <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
New-SCLogicalSwitchVirtualNetworkAdapter コマンドレットは、論理スイッチ定義の一部としてアップリンク ポート プロファイルにホストの仮想ネットワーク アダプター (VNIC) を追加します。
例
例 1: 新しい論理スイッチ仮想ネットワーク アダプターを作成する
PS C:\> $UPPSet = Get-SCUplinkPortProfileSet -Name "R1Uplink"
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "MgmtNet"
PS C:\> New-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_Storage" -UplinkPortProfileSet $uppSetVar -RunAsynchronously -VMNetwork $vmNetwork -VLanEnabled $true -VLanID 2162 -IsUsedForHostManagement $false -IPv4AddressType "Dynamic" -IPv6AddressType "Dynamic"
最初のコマンドは、Get-SCUplinkPortProfileSet コマンドレットを使用してアップリンク ポート プロファイル セットを取得し、$UPPSet変数に格納します。
2 番目のコマンドは、Get-SCVMNetwork コマンドレットを使用して MgmtNet という名前の仮想マシン ネットワークを取得し、$VmNetwork変数に格納します。
最後のコマンドは、論理スイッチと共にホストにデプロイされる論理スイッチ仮想ネットワーク アダプターを作成します。
パラメーター
-Description
仮想ネットワーク アダプターの説明を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EthernetAddressType
イーサネット アドレスの種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- 動的
- 静的
型: | EthernetAddressType |
指定可能な値: | Dynamic, Static |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InheritsAddressFromPhysicalNetworkAdapter
ネットワーク アダプターが物理ネットワーク アダプターからアドレスを継承するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IPv4AddressPool
IPv4 アドレスを含む静的アドレス プールを指定します。
型: | StaticIPAddressPool |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IPv4AddressType
IPv4 アドレスの種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- 動的
- 静的
型: | EthernetAddressType |
指定可能な値: | Dynamic, Static |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IPv6AddressPool
IPv6 アドレスを含む静的アドレス プールを指定します。
型: | StaticIPAddressPool |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IPv6AddressType
IPv6 アドレスの種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- 動的
- 静的
型: | EthernetAddressType |
指定可能な値: | Dynamic, Static |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IsUsedForHostManagement
仮想ネットワーク アダプターをホスト管理に使用するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
ネットワーク アダプターの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PortClassification
仮想ネットワーク アダプターが接続するスイッチのポート分類を指定します。
型: | PortClassification |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UplinkPortProfileSet
アップリンク ポート プロファイル セット オブジェクトを指定します。
アップリンク ポート プロファイル セット オブジェクトを取得するには、Get-SCUplinkPortProfileSet コマンドレットを使用します。
型: | UplinkPortProfileSet |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VLanEnabled
Hyper-V または Citrix XenServer ホスト上の仮想マシンで使用する仮想 LAN (VLAN) を有効にするかどうかを示します。
- 単一 VLAN のフォーマット例:
-VLANEnabled -VLANMode "Access" -VLANID 35
- 複数の VLAN の形式の例:
-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VLanID
1 から 4094 の範囲の数値識別子を、仮想マシン上の仮想ネットワーク アダプターまたは仮想マシン ホスト上の物理ネットワーク アダプターに割り当てます。
VLan モードが Access の場合、外部にバインドされた物理ネットワーク アダプター上の Hyper-V、VMware ESX、または Citrix XenServer ホストで VLanID を構成します。
ホスト上の物理ネットワーク アダプターにバインドされているか、ホスト上の内部仮想ネットワークにバインドされている仮想マシンの仮想ネットワーク アダプターで VLanID を構成します。
形式の例: -VLanEnabled -VLanMode "Access" -VLANID 35
型: | UInt16 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMNetwork
VM ネットワーク オブジェクトを指定します。
VM ネットワーク オブジェクトを取得するには、Get-SCVMNetwork コマンドレットを使用します。
型: | VMNetwork |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMSubnet
仮想マシン サブネット オブジェクトを指定します。
VMSubnet オブジェクトを取得するには、Get-SCVMSubnet コマンドレットを使用します。
型: | VMSubnet |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |