SCVMM 2016 UR5 で利用可能なコマンドレット (Get-SCLogicalNetworkDefinition) について

System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。

ここでは Get-SCLogicalNetworkDefinition コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Get-SCLogicalNetworkDefinition」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。

Get-SCLogicalNetworkDefinition コマンドレット

名前

Get-SCLogicalNetworkDefinition

概要

論理ネットワークの定義を取得します。

構文

Get-SCLogicalNetworkDefinition
 [[-Name] <String>]
 -Cloud <Cloud>
 [-LogicalNetwork <LogicalNetwork>]
 [-ReturnAllTypes]
 [-Subnet <String>]
 [-VLanID <Int32>]
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Get-SCLogicalNetworkDefinition
 [[-Name] <String>]
 -ID <Guid>
 [-LogicalNetwork <LogicalNetwork>]
 [-ReturnAllTypes]
 [-Subnet <String>]
 [-VLanID <Int32>]
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Get-SCLogicalNetworkDefinition
 [[-Name] <String>]
 [-LogicalNetwork <LogicalNetwork>]
 [-ReturnAllTypes]
 [-Subnet <String>]
 [-VLanID <Int32>]
 -VMHostGroup <HostGroup>
 [-VMMServer <ServerConnection>]
 [<CommonParameters>]

説明

Get-SCLogicalNetworkDefinition コマンドレットは、複数の論理ネットワークの定義情報を取得します。論理ネットワークの定義 (ネットワーク サイトとも呼ばれる)は、複数の論理ネットワークに関連付けることが可能です。

パラメーター

-Cloud <Cloud>

プライベート クラウド オブジェクトを指定します。

必須true
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-ID <Guid>

特定のオブジェクトに対するグローバル一意識別子、もしくは GUID として数値 ID を指定します。

必須true
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-LogicalNetwork <LogicalNetwork>

論理ネットワークを指定します。論理ネットワークは、IP サブネットと仮想ローカル エリア ネットワーク (VLAN) の名前付きグループであり、ネットワーク割り当てを整理して単純化するために使用されます。

必須false
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-Name <String>

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

必須false
位置0
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-ReturnAllTypes [<SwitchParameter>]

このコマンドレットが任意の分離型の論理ネットワーク定義を返す場合に指定します。

必須false
位置named
既定値False
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-Subnet <String>

クラスレス ドメイン間ルーティング (CIDR) 記法の IP サブネット (IPv4 もしくは IPv6) を指定します。

  • IPv4 サブネットに対するフォーマット例 : 192.168.0.1/24
  • IPv6 サブネットに対するフォーマット例 : FD4A:29CD:184F:3A2C::/64

注 : IP サブネットは、ホストグループ、もしくは子ホスト グループの他のサブネットと重複することはできません。

必須false
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-VLanID <Int32>

仮想マシン上の仮想ネットワーク アダプター、もしくは仮想マシン ホスト上の物理ネットワーク アダプターの数値識別子を 1~4094 の範囲で指定します。

Vlan モードが Access の場合、外部接続された物理ネットワーク アダプター上の Hyper-V、VMware ESX、もしくは Citrix XenServer ホストで VLanID を構成します。

仮想マシンの仮想ネットワーク アダプターに VLanID を設定するには、次のどちらかの方法があります :

  • ホスト上の物理ネットワークにバインドされています。
  • ホスト上の内部仮想ネットワークにバインドされています。
必須false
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-VMHostGroup <HostGroup>

仮想マシン ホスト グループ オフジェクトを指定します。

必須true
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-VMMServer <ServerConnection>

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

必須false
位置named
既定値None
パイプライン入力を許可するTrue (ByValue)
ワイルドカード文字を許可するfalse

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

入力

出力

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

メモ

例 1 : 論理ネットワークに対する論理ネットワークの定義情報を取得する

コマンド
$LogicalNetwork = Get-SCLogicalNetwork -Name "LogicalNetwork01"
$HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup01" }
Get-SCLogicalNetworkDefinition -LogicalNetwork $LogicalNetwork -VMHostGroup $HostGroup
コマンドの説明

最初のコマンドは、論理ネットワーク “LogicalNetwork01” を取得し、$LogicalNetwork 変数に格納します。

2 番目のコマンドは、ホスト グループ “HostGroup01” を取得し、$HostGroup 変数に格納します。

3 番目のコマンドは、$LogicalNetwork に格納されている論理ネットワークの論理ネットワークの定義と、$HostGroup 変数に格納されているホスト グループ (継承が有効な場合はその親ホストグループを含む) を取得します。

関連するリンク

  • New-SCLogicalNetworkDefinition
  • Remove-SCLogicalNetworkDefinition
  • Set-SCLogicalNetworkDefinition
  • Set-SCVMHostNetworkAdapter

参考

System Center VMM 2016
タイトルとURLをコピーしました