VMware PowerCLI リファレンス
VMware PowerCLI コマンドリファレンス
目次
1.ホスト接続/切断
1-1.ESXiホスト接続
1-2.ESXiホスト切断
2.ネットワーク設定
2-1.ホスト名/DNS/ドメイン/ドメインサフィックス確認
2-2.ホスト名/DNS/ドメイン/ドメインサフィックス設定
2-3.vSwitch 確認
2-4.vSwitch 作成
2-5.vSwitch 設定変更
2-6.vSwitch ネットワークアダプタ情報取得
2-7.vSwitch ネットワークアダプタ設定
2-8.vSwitch セキュリティ確認
2-9.vSwitch セキュリティ設定
2-10.vSwitch チーミング確認
2-11.vSwitch チーミング設定
2-12.ポートグループ確認
2-13.ポートグループ作成
2-14.ポートグループセキュリティ確認
2-15.ポートグループセキュリティ設定
2-16.ポートグループチーミング確認
2-17.ポートグループチーミング設定
2-18.vmkernel 確認
2-19.vmkernel 作成
2-20.vmkernel MTU確認
2-21.vmkernel MTU設定
2-22.NTP 確認
2-23.NTP 設定
2-24.サービス確認
2-25.サービス操作
2-26.ファイアウォール確認
2-27.ファイアウォール操作
3.ユーザ作成/権限変更
3-1.ユーザ確認
3-2.ユーザ作成
3-3.ユーザ権限確認
3-4.ユーザ権限変更
4.ホスト-管理-詳細設定操作
4-1.ログ初期サイズ確認
4-2.ログ初期サイズ変更
1.ホスト接続/切断
1-1.ESXiホスト接続
- 説明
このコマンドレットは、vCenter Server システムへの接続を確立します。
このコマンドレットは、指定されたパラメーターを使用して vCenter Server システムとの新しいセッションを開始するか、以前のセッションを再確立します。
サーバーへの接続を試みると、サーバーは有効な証明書をチェックします。
有効な証明書が認識されない場合、VMware PowerCLI デフォルトの動作を設定するには、 Set-PowerCLIConfiguration コマンドレットのInvalidCertificateAction パラメーターを
使用します。
無効な証明書の詳細については、「Get-Help about_invalid_certificates」を
実行してください。
同じサーバーに複数の接続を行うことができます。 サーバーから切断するには、このサーバーへのアクティブな接続をすべて閉じる必要が
あります。
VMware PowerCLI は、複数のデフォルト サーバーでの作業をサポートしています。
このオプションを選択すると、Connect-VIServerコマンドレットを使用して
別のサーバーに接続するたびに、NotDefaultパラメータが設定されていない限り、
新しいサーバー接続が以前に接続されていたサーバーと一緒に配列変数に格納されます。
この変数は $DefaultVIServers という名前で、初期値は空の配列です。
コマンドレットを実行し、指定されたパラメーターからターゲット サーバーを
決定できない場合、コマンドレットは配列変数に格納されているすべてのサーバーに
対して実行されます。
変数 $DefaultVIServers からサーバーを削除するには、
Disconnect-Server コマンドレットを使用してサーバーへのすべてのアクティブな接続を
閉じるか、$DefaultVIServers の値を手動で変更します。
単一のデフォルト サーバーを使用することを選択した場合、コマンドレットを実行して、
指定されたパラメーターからターゲット サーバーを決定できないとき、
コマンドレットは最後に接続されたサーバーに対して実行されます。
このサーバーは、$defaultVIServer 変数に格納され、
新しい接続を確立するたびに更新されます。
単一および複数のデフォルト サーバーの作業モードを切り替えるには、
Set-PowerCLIConfiguration コマンドレットの DefaultServerMode パラメーターを
使用します。
複数のデフォルトサーバーでの作業は、将来のリリースでデフォルトで有効になる予定です。
- 書式
Connect-VIServer -Server <String[]> [-AllLinked] [-Credential <PSCredential>] [-Force] [-NotDefault] [-Password <String>] [-Port <Int32>] [-Protocol <String>] [-SaveCredentials] [-Session <String>] [-User <String>] [CommonParameters]
- コマンド例:
Connect-VIServer -Server ”IPAddress or hostname” -Force -Password ”パスワード” -Port 443 -Protocol https -User ”root”
- オプション説明
オプション名 | 説明 |
-Server <String[]> |
接続先となるvSphereサーバーのIPアドレスまたはDNS名を指定します。 また、[fe80::250:56ff:feb0:74bd%4] のように、 角括弧で囲まれたIPv6アドレスを指定することもできます。 |
[-Force] |
コマンドレット実行中のすべての ユーザー インターフェイス プロンプトを抑制します。 現在、これらには「Multiple default servers」および 「Invalid certificate action」が含まれます。 |
[-Password <String>] |
サーバーとの認証に使用するパスワードを指定します。 Credentialパラメータも指定されている場合は、 このパラメータは無視されます。 PowerCLIのサーバー認証ロジックの詳細については、 「help about_server_authentication」を実行してください。 注意:パスワードに特殊文字が含まれている場合は、 文字列全体を一重引用符(').で囲みます。 |
[-Port <Int32>] |
接続に使用するサーバーのポートを指定します。 |
[-Protocol <String>] |
接続に使用するインターネットプロトコルを 指定します。 http または https のいずれかを指定します。 |
[-User <String>] |
サーバーとの認証に使用するユーザー名を指定します。 Credentialパラメータも指定されている場合、 このパラメータは無視されます。 PowerCLIのサーバー認証ロジックの詳細については、 "help about_server_authentication "を実行してください。 パイプラインを通じてこのパラメータに値を渡すことは非推奨で、将来のリリースでは無効になる予定です。 注:ユーザー名に特殊文字が含まれている場合は、 文字列全体を一重引用符(')で囲んでください。 |
1-2.ESXiホスト切断
- 説明
指定したサーバーへのすべてのアクティブな接続を閉じて、
そのサーバーから切断することを示します。
値が:$false の場合、コマンドレットは指定したサーバーへの最後の接続のみを閉じ、
このサーバーとの接続を解除するには、
このサーバーへの各アクティブな接続に対して Disconnect-VIServer を
実行する必要があります。
- 書式
Disconnect-VIServer [-Server <VIServer[]>] [CommonParameters] [-Force]
- コマンド例:
disconnect-viserver -server ”IPAddress or hostname”
- オプション
オプション名 | 説明 |
[-Server <VIServer[]>] | 切断するvCenter/Serverシステムを指定します。 |
[-Force] |
指定したサーバーへのすべてのアクティブな接続を閉じて、 そのサーバーから切断することを示します。 値が $false の場合、コマンドレットは指定したサーバーへの 最後の接続のみを閉じ、このサーバーとの接続を解除するには、 このサーバーへの各アクティブな接続に対して Disconnect-VIServer を実行する必要があります。 |
2.ネットワーク設定
2-1.ホスト名/DNS/ドメイン/ドメインサフィックス確認
- 説明
このコマンドレットは、vCenter Server システム上のホスト ネットワークを取得します。
このコマンドは、VMHost パラメーターで指定されたホストのネットワーク構成を取得します。
既定のサーバーとは異なるサーバーを指定するには、Server パラメーターを使用します。
- 書式
Get-VMHostNetwork -VMHost <VMHost[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Get-VMHostNetwork -VMHost ”IPAddress or hostname”
- オプション説明
オプション名 | 説明 |
VMHost[] | ネットワーク設定を取得したいホストを指定します。 |
VIServer[] |
cmdlet を実行する vCenter Server システムを指定します。 値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、 コマンドは既定のサーバーで実行されます。 既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-2.ホスト名/DNS/ドメイン/ドメインサフィックス設定
- 説明
このコマンドレットは、指定された仮想ネットワークを更新します。サービス コンソールと VM カーネルは同じネットワークに接続されていないことが多く、そのためそれぞれが独自のゲートウェイ情報を必要とします。ゲートウェイは、サービス コンソールや VM カーネルと同じ IP サブネット上にないマシンへの接続に必要です。
- 書式
Set-VMHostNetwork -Network <VMHostNetworkInfo[]> [-ConsoleGateway <String>] [-ConsoleGatewayDevice <String>] [-ConsoleV6Gateway <String>] [-ConsoleV6GatewayDevice <String>] [-DnsAddress <String[]>] [-DnsDhcpDevice <Object>] [-DnsFromDhcp <Boolean>] [-DomainName <String>] [-HostName <String>] [-IPv6Enabled <Boolean>] [-SearchDomain <String[]>] [-VMKernelGateway <String>] [-VMKernelGatewayDevice <String>] [-VMKernelV6Gateway <String>] [-VMKernelV6GatewayDevice <String>] [CommonParameters]
- コマンド例:
Get-VMHostNetwork | Set-VMHostNetwork -DnsAddress "DNS1,DNS2" -DnsFromDhcp $false -HostName "New_Host_Name" -SearchDomain "DNS1,DNS2" -DomainName "Domain.Nmae"
- オプション説明
オプション名 |
説明 | |
|
設定したいホストネットワークを指定します。 | |
ConsoleGateway | 新しいコンソールゲートウェイを指定します。 | |
ConsoleGatewayDevice | 新しいコンソール・ゲートウェイ・デバイスを指定します | |
ConsoleV6Gateway | コンソールV6ゲートウェイアドレスを指定します。ESXiではサポートされていません。 | |
ConsoleV6GatewayDevice |
コンソールV6ゲートウェイデバイスを指定します。ESXiではサポートされていません。 | |
DnsAddress | 新しいDNSアドレスを指定します。 | |
DnsDhcpDevice | DnsFromDhcpパラメータの値が「true」の場合、このパラメータは必須です。それ以外の場合は無視されます。DnsDhcpDevice パラメーターが設定されている場合は、サービスコンソールまたは VMKernel ネットワークアダプターの Dhcp DNS がシステム DNS より優先されます。このパラメータには、ServiceConsoleNIC オブジェクト、ESX visor の場合は VMKernelNIC オブジェクト、または文字列としての NIC 名が渡されます。 | |
DnsFromDhcp | Dhcpサーバーからネットワーク設定を取得することを示します。 |
|
DomainName | 新しいドメイン名を指定します。 | |
HostName | 新しいホスト名を指定します。 | |
IPv6Enabled | IPv6 の設定が有効であることを示します。このパラメーターを$falseに設定すると、ConsoleV6Gateway、ConsoleV6GatewayDevice、およびVMKernelV6Gatewayパラメーターが無効になります。IPv6 は、vCenter 4.1 および ESX 4.1 以降でのみサポートされています。ESX で IPv6 を使用するには、IPv6 を有効にした後、ホストを再起動する必要があります。 | |
SearchDomain | 新しい検索ドメインを指定します。 | |
VMKernelGateway | 新しいカーネルゲートウェイを指定します。 | |
|
新しいカーネルゲートウェイデバイスを指定します。 |
|
VMKernelV6Gateway | VMKernel V6 ゲートウェイアドレスを指定します。このパラメーターは、ESX ホストでのみサポートされています。 | |
VMKernelV6GatewayDevice | VMKernel V6 ゲートウェイ デバイスを指定します。このパラメーターは、ESX ホストでのみサポートされています。 |
2-3.vSwitch 確認
- 説明
このコマンドレットは、仮想マシン ホストに関連する、または仮想マシンが使用する仮想スイッチを取得します。VMHost および VM パラメーターの少なくとも 1 つを提供する必要があります。VM、VMHost、Name パラメーターは、衝突のため、パイプラインを介した文字列値を受け付けません。デフォルトのサーバーとは異なるサーバーを指定する場合は、Server パラメーターを使用します。
- 書式
Get-VirtualSwitch [[-VM] <VirtualMachine[]>] [-Datacenter <Datacenter[]>] [-Distributed] [-Name <String[]>] [-Server <VIServer[]>] [-Standard] [-VMHost <VMHost[]>] [CommonParameters]
- コマンド例
Get-VirtualSwitch -Name ”NETWORK_VSWITCH0_NAME”
- オプション説明
オプション名 | 説明 |
VM | 仮想スイッチを取得したい仮想マシンを指定します。 |
Datacenter | 指定したデータセンターのホストに接続されている仮想スイッチを再検索する仮想マシンを指定します。 |
Distributed | DistributedSwitchオブジェクトのみを取得したいことを示します。このパラメーターは廃止されました。分散スイッチを取得するには、代わりに Get-VDSwitch コマンドレットを使用します。 |
Name | 取得したい仮想スイッチの名前を指定します。パイプラインを通じてこのパラメーターに値を渡すことは非推奨で、将来のリリースでは無効になります。このパラメータの位置は非推奨であり、将来のリリースで変更される予定です。既存のスクリプトを今後のPowerCLIバージョンで実行する際にエラーが発生しないように、パラメータを名前で指定してください。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
Standard | VirtualSwitchオブジェクトのみを取得したいことを示します。 |
VMHost | バーチャルスイッチを取得したいホストを指定します。このパラメータの位置は非推奨で、将来のリリースで変更される予定です。既存のスクリプトを今後のPowerCLIのバージョンで実行したときにエラーが発生しないように、パラメータを名前で指定してください。 |
2-4.vSwitch 作成
- 説明
このコマンドレットは、VMHost パラメーターで指定されたホスト上に新しい仮想スイッチを作成します。
- 書式
New-VirtualSwitch [-Name] <String> -VMHost <VMHost> [[-NumPorts] <Int32>] [[-Nic] <PhysicalNic[]>] [[-Mtu] <Int32>] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:vmnic2,6 を組み込み、vSwitch1 を作成
Get-VMHost ”IPAddress or hostname” | New-VirtualSwitch -Name "vSwitch1" -Nic vmnic2,vmnic6
- オプション説明
オプション名 | 説明 |
Name | 新しい仮想スイッチの名前を指定します。 |
VMHost | 新しい仮想スイッチを作成するホストを指定します。 |
NumPorts | 仮想スイッチのポート番号を指定します。この値は、指定された数値よりも大きい、最も近い正確な2の累乗に丸められます(たとえば、ユーザーが67を指定した場合、この数値は128に丸められます)。vSphere Clientに表示されるポート番号は、NumPortsパラメータに指定した値とは異なる場合がありますのでご注意ください。注:ESX 5.5以降では、標準的な仮想スイッチは常にエラスティックであるため、NumPortsパラメータは適用できず、その値は無視されます。 |
Nic | 新しい仮想スイッチのActive NICに追加する物理ネットワークインターフェースカードを指定します。このパラメーターは、オブジェクトと文字列の両方を受け付けます。 |
Mtu | 指定した仮想スイッチに関連する最大伝送単位(MTU)を指定します(単位:バイト)。MTUの値は常に0より大きくなります。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-5.vSwitch 設定変更
- 説明
このコマンドレットは、指定された仮想スイッチのプロパティを変更します。サーバーは、NumPorts パラメーターの値を丸めて、指定された数よりも大きい、最も近い正確な 2 の累乗にします。NumPorts を更新する場合は、変更を有効にするために ESX/ESXi ホストを再起動する必要があります。
- 書式
Set-VirtualSwitch -VirtualSwitch <VirtualSwitch[]> [[-NumPorts] <Int32>] [[-Nic] <String[]>] [[-Mtu] <Int32>] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Set-VirtualSwitch -VirtualSwitch $vswitch -MTU 9000
- オプション説明
オプション名 | 説明 |
VirtualSwitch | 設定する仮想スイッチを指定します。 |
NumPorts | VirtualSwitchのポート番号を指定します。この値は、指定された数値よりも大きい、最も近い正確な2の累乗に丸められます(例えば、ユーザーが67を指定した場合、この数値は128に丸められます)。変更を有効にするには、仮想スイッチが属するESXホストを再起動する必要があります。なお、vSphere Clientに表示されるポート番号は、NumPortsパラメータに指定した値と異なる場合があります。注:ESX 5.5以降では、標準の仮想スイッチは常にエラスティックであるため、NumPortsパラメータは適用できず、その値は無視されます。 |
Nic | 仮想スイッチの新しいネットワークインターフェースカードを指定します。古いNICは指定されたNICで置き換えられます。 |
Mtu | 指定した仮想スイッチに関連する最大伝送単位(MTU)を指定します(単位:バイト)。MTUの値は0より大きくなければなりません。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-6.vSwitch ネットワークアダプタ情報取得
- 説明
このコマンドレットは、vCenter Server システムで利用可能な仮想ネットワーク アダプターを取得します。このコマンドレットは、VirtualMachine、Template、および Snapshot の各パラメーターで指定された仮想マシン、テンプレート、およびスナップショットに割り当てられた仮想ネットワーク アダプターのセットを返します。これらのパラメーターのうち、少なくとも 1 つを提供する必要があります。デフォルトのサーバーとは異なるサーバーを指定するには、Server パラメーターを使用します。
- 書式
Get-NetworkAdapter [[-Template] <Template[]>] [[-Snapshot] <Snapshot[]>] [-Id <String[]>] [-Name <String[]>] [-Server <VIServer[]>] [-VM <VirtualMachine[]>] [CommonParameters]
- コマンド例:vmnic0 情報取得
Get-VMHostNetworkAdapter -VMHost "IPAddress or hostname" -Physical -Name "vmnic0"
- オプション説明
オプション名 | 説明 |
Template | 仮想ネットワークアダプターを取得するためのテンプレートを指定します。 |
Snapshot | 仮想ネットワークアダプターを取得する対象となるスナップショットを指定します。 |
Id | 取得したいネットワークアダプターのIDを指定します。注:Idパラメータに値のリストを指定した場合、返されるオブジェクトのIDは、そのリストに含まれる文字列値のいずれかに正確に一致することになります。 |
Name | 取得したいネットワークアダプターの名前を指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
VM | 仮想ネットワークアダプターを取得する対象の仮想マシンを指定します。 |
2-7.vSwitch ネットワークアダプタ設定
- 説明
このコマンドレットは、標準の仮想スイッチにホスト物理 NIC を追加します。VMHost 仮想ネットワーク アダプターが指定されている場合、このコマンドレットはそれらを仮想スイッチにも移行します。注意: VMHost 仮想ネットワーク アダプターが指定されている場合、このコマンドレットはそれらをそれぞれのポート グループに移行するか、VirtualNicPortgroup が指定されていない場合は新しいポート グループを作成します。
- 書式
Add-VirtualSwitchPhysicalNetworkAdapter [-VirtualSwitch] <VirtualSwitch> -VMHostPhysicalNic <PhysicalNic[]> [-Server <VIServer[]>] [-VMHostVirtualNic <HostVirtualNic[]>] [-VirtualNicPortgroup <VirtualPortGroup[]>] [CommonParameters]
- コマンド例:
# ”vmnic1” 要素を格納
$NETWORK_VSWITCH0_VMNIC0_ARRAY_ELEMENT = Get-VMHostNetworkAdapter -VMHost $SERVER_IPA -Physical -Name $NETWORK_VSWITCH0_NIC
# vSwitch に"vmnic1" 追加
Get-VirtualSwitch -Name "vSwitch名" | Add-VirtualSwitchPhysicalNetworkAdapter -VMHostPhysicalNic $NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_1
# ネットワークインタフェースアダプター追加
Get-VirtualSwitch -Name $NETWORK_VSWITCH0_NAME | Add-VirtualSwitchPhysicalNetworkAdapter -VMHostPhysicalNic $NETWORK_VSWITCH0_VMNIC0_ARRAY_ELEMENT -Confirm:$false | Out-File -a $LOGFOLDER_LOGFILE
- オプション説明
オプション名 | 説名 |
VirtualSwitch | 物理ネットワークアダプターまたは仮想ネットワークアダプターの移行先となる標準仮想スイッチを指定します。 |
VMHostPhysicalNic | 標準仮想スイッチに追加または移行するホスト物理ネットワークアダプターを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
VMHostVirtualNic | 物理アダプタと一緒に移行するホスト仮想ネットワークアダプタを指定して、その接続性を維持すること。 |
VirtualNicPortgroup | ホストの仮想ネットワークアダプタをアタッチするポートグループを指定します。指定した仮想ネットワークアダプタの数と同じ数のポートグループを受け入れます。1つ目のアダプタは1つ目のポートグループに、2つ目のアダプタは2つ目のポートグループに...というように接続されます。 |
2-8.vSwitch セキュリティ確認
- 説明
このコマンドレットは、仮想ポート グループのセキュリティ ポリシー、または仮想スイッチのデフォルトのポート セキュリティ ポリシーを取得します。
- 書式
Get-SecurityPolicy -VirtualPortGroup <VirtualPortGroup[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Get-VirtualSwitch "MyVirtualSwitch" | Get-SecurityPolicy
- オプション説明
オプション名 | 説名 |
VirtualPortGroup | セキュリティポリシーを取得する仮想ポートグループを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-9.vSwitch セキュリティ設定
- 説明
このコマンドレットは、指定された NIC チーミング ポリシーを変更します。ロード バランシングやフェイルオーバーの設定を変更することができます。デフォルトの NIC チーミング ポリシーは仮想スイッチ全体に設定され、ポート グループ レベルで上書きすることができます。
- 書式
Set-SecurityPolicy -VirtualPortGroupPolicy <VirtualPortgroupSecurityPolicy[]> [-AllowPromiscuous <Boolean>] [-AllowPromiscuousInherited <Boolean>] [-ForgedTransmits <Boolean>] [-ForgedTransmitsInherited <Boolean>] [-MacChanges <Boolean>] [-MacChangesInherited <Boolean>] [CommonParameters]
- コマンド例:無差別モード(無効)、MAC アドレス変更(有効)、偽装転送(有効)にする場合
Get-VirtualSwitch -Name "vSwitch名" | Get-SecurityPolicy | Set-SecurityPolicy -AllowPromiscuous:$false -MacChanges:$true -ForgedTransmits:$true
- オプション説明
オプション名 | 説名 | |
VirtualPortGroupPolicy | 設定する仮想ポートグループのセキュリティポリシーを指定します。 | |
AllowPromiscuous | 対応する仮想ポートグループまたはスイッチでプロミスキャスモードを有効にするかどうかを指定します。 | |
|
AllowPromiscuousの設定を親仮想スイッチから引き継ぐかどうかを指定します。 | |
ForgedTransmits | 対応する仮想ポートグループまたはスイッチでフォージドトランジットを有効にするかどうかを指定します。 | |
ForgedTransmitsInherited | ForgedTransmitsの設定を親仮想スイッチから引き継ぐかどうかを指定します。 | |
MacChanges | 対応する仮想ポートグループまたはスイッチでMACアドレスの変更を有効にするかどうかを指定します。 | |
MacChangesInherited | MacChangesの設定を親仮想スイッチから引き継ぐかどうかを指定します。 |
2-10.vSwitch チーミング確認
- 説明
このコマンドレットは、仮想マシン ホストに関連する、または仮想マシンが使用する仮想スイッチを取得します。VMHost および VM パラメーターの少なくとも 1 つを提供する必要があります。VM、VMHost、Name パラメーターは、衝突のため、パイプラインを介した文字列値を受け付けません。デフォルトのサーバーと異なるサーバーを指定する場合は、Server パラメーターを使用します。
- 書式
Get-NicTeamingPolicy -VirtualPortGroup <VirtualPortGroup[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例
Get-VirtualSwitch -VMHost (Get-VMHost ”IPAddress or hostname”) -Name vSwitch0 | Get-NicTeamingPolicy
- オプション説明
オプション名 | 説名 |
VirtualPortGroup | NICチーミングポリシーを取得したいポートグループを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-11.vSwitch チーミング設定
- 説明
このコマンドレットは、指定された NIC チーミング ポリシーを変更します。ロード バランシングやフェイルオーバーの設定を変更することができます。デフォルトの NIC チーミング ポリシーは仮想スイッチ全体に設定され、ポート グループ レベルで上書きすることができます。
- 書式
Set-NicTeamingPolicy -VirtualPortGroupPolicy <NicTeamingVirtualPortGroupPolicy[]> [-FailbackEnabled <Boolean>] [-InheritFailback <Boolean>] [-InheritFailoverOrder <Boolean>] [-InheritLoadBalancingPolicy <Boolean>] [-InheritNetworkFailoverDetectionPolicy <Boolean>] [-InheritNotifySwitches <Boolean>] [-LoadBalancingPolicy <LoadBalancingPolicy>] [-MakeNicActive <PhysicalNic[]>] [-MakeNicStandby <PhysicalNic[]>] [-MakeNicUnused <PhysicalNic[]>] [-NetworkFailoverDetectionPolicy <NetworkFailoverDetectionPolicy>] [-NotifySwitches <Boolean>] [CommonParameters]
- コマンド例
# ”vmnic2” 要素を格納
$NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_1 = Get-VMHostNetworkAdapter -VMHost "IPAddress or hostname" -Physical -Name "vmnic2"
# ”vmnic3” 要素を格納
$NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_2 = Get-VMHostNetworkAdapter -VMHost "IPAddress or hostname" -Physical -Name "vmnic3"
#チーミングポリシー設定
Get-VirtualSwitch -Name "vSwitch名" | Get-NicTeamingPolicy | Set-NicTeamingPolicy -LoadBalancingPolicy "ExplicitFailover" -NetworkFailoverDetectionPolicy "LinkStatus" -NotifySwitches:$true -FailbackEnabled:$true -MakeNicActive $NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_1,$NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_2
- オプション説明
オプション名 | 説名 |
VirtualPortGroupPolicy | 設定する仮想ポートグループポリシーを指定します。 |
FailbackEnabled | 物理アダプタが障害から回復した後にアクティブな状態に戻る方法を指定します。この値が $true の場合、アダプタは回復後すぐにアクティブに戻され、そのスロットを引き継いだスタンバイ・アダプタがある場合はその代わりとなります。この値が $false の場合、障害が発生したアダプタは回復してもアクティブなアダプタが故障して交換が必要になるまで非アクティブのままになります。 |
InheritFailback | FailbackEnabledパラメーターの値が仮想スイッチから継承されていることを示す。 |
InheritFailoverOrder | MakeNicActive、MakeNicStandBy、MakeNicUnusedパラメータの値が仮想スイッチから継承されることを示す。 |
InheritLoadBalancingPolicy | LoadBalancingPolicyパラメータの値が仮想スイッチから継承されていることを示す。 |
InheritNetworkFailoverDetectionPolicy | NetworkFailoverDetectionPolicyパラメータの値が仮想スイッチから継承されていることを示す。 |
InheritNotifySwitches | NotifySwitchesパラメータの値が仮想スイッチから継承されることを示す。 |
LoadBalancingPolicy |
スイッチに割り当てられたネットワークアダプタ間のネットワークトラフィックの分配方法を決定します。以下の値が有効です。 LoadBalanceIP - IPハッシュに基づいてルートを設定します。各パケットの送信元と送信先のIPアドレスのハッシュに基づいて、アップリンクを選択します。非 IP パケットの場合は、それらのオフセットにあるものがハッシュの計算に使用されます。 LoadBalanceSrcMac - ソースMACハッシュに基づいてルートを設定します。ソースイーサネットのハッシュに基づいてアップリンクを選択します。 LoadBalanceSrcId - 発信元のポートIDに基づいてルートを設定します。トラフィックが仮想スイッチに入った仮想ポートに基づいてアップリンクを選択します。 ExplicitFailover - アクティブなアダプタのリストから、フェイルオーバー検出基準に合格した最高順序のアップリンクを常に使用します。 |
MakeNicActive | ネットワークアダプターの接続が可能でアクティブな場合に、継続して使用するアダプターを指定します。 |
MakeNicStandby | アクティブなアダプタのいずれかの接続が利用できない場合に使用するアダプタを指定します。 |
MakeNicUnused | 使用しないアダプターを指定します。 |
NetworkFailoverDetectionPolicy |
アダプタの障害時にトラフィックを再ルーティングする方法を指定します。以下の値が有効です。 LinkStatus - ネットワークアダプタが提供するリンクステータスにのみ依存します。このオプションは、ケーブルの引き抜きや物理スイッチの電源障害などの障害を検出しますが、物理スイッチのポートがスパニングツリーによってブロックされたり、誤ったVLANに設定されていたり、物理スイッチの反対側でケーブルが引き抜かれたりするような構成エラーは検出しません。 BeaconProbing - チーム内のすべてのNICにビーコンプローブを送信して聞き取りを行い、リンクステータスに加えてこの情報を使用してリンク障害を判断します。このオプションは、リンクステータスだけでは検出できない上述の障害の多くを検出します。 |
NotifySwitches | 仮想スイッチに仮想NICが接続されたとき、またはフェイルオーバーイベントによりその仮想NICのトラフィックがチーム内の異なる物理NICを経由してルーティングされたときに、物理スイッチのルックアップテーブルを更新するための通知がネットワーク経由で送信されることを示します。 |
2-12.ポートグループ確認
- 説明
このコマンドレットは、ホスト、仮想マシン、および仮想スイッチの利用可能なポート グループを取得します。既定のサーバーとは異なるサーバーを指定するには、Server パラメーターを使用します。
- 書式
Get-VirtualPortGroup [-Datacenter <Datacenter[]>] [-Distributed] [-Name <String[]>] [-Server <VIServer[]>] [-Standard] [-Tag <Tag[]>] [-VM <VirtualMachine[]>] [-VMHost <VMHost[]>] [-VirtualSwitch <VirtualSwitchBase[]>] [CommonParameters]
- コマンド例
Get-VirtualPortGroup | Get-SecurityPolicy | Sort VirtualPortGroup
- オプション説明
オプション名 | 説名 | |
Datacenter | 指定したデータセンターのホストに接続されている仮想スイッチのポートグループをフィルタリングします。 | |
Distributed | DistributedSwitchオブジェクトのポートグループを取得したいことを示します。このパラメーターは廃止されました。分散ポート グループを取得するには、代わりに Get-VDPortgroup コマンドレットを使用します。 | |
Name | 取得したいポートグループの名前を指定します。 | |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 | |
Standard |
|
|
Tag | 指定したタグのいずれかに関連付けられているバーチャルポートグループのみを返します。注意:このパラメータは、標準的な仮想ポートグループにのみ対応しています。分散型ポートグループの場合は、Get-VDPortgroupコマンドレットを使用する必要があります。 | |
VM | ポートグループを取得したい仮想マシンを指定します。 | |
VMHost | ポートグループを取得したいホストを指定します。このパラメータの位置は非推奨で、将来のリリースで変更される予定です。既存のスクリプトを今後のPowerCLIバージョンで実行する際にエラーが発生しないように、パラメータを名前で指定してください。 | |
VirtualSwitch | ポートグループを取得したい仮想スイッチを指定します。 |
2-13.ポートグループ作成
- 説明
このコマンドレットは、提供されたパラメーターを使用して、ホスト上に新しいポート グループを作成します。
- 書式
New-VirtualPortGroup [-VirtualSwitch] <VirtualSwitch> -Name <String> [-Server <VIServer[]>] [-VLanId <Int32>] [CommonParameters]
- コマンド例:「vSwitch0」に「VLAN 100」のポートグループを作成
New-VirtualPortGroup -VirtualSwitch "vSwitch0" -Name "PortGroup名" -VLanId 100
- オプション説明
オプション名 | 説名 |
VirtualSwitch | 新しいポートグループを作成する仮想スイッチを指定します。 |
Name | 新しいポートグループの名前を指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
VLanId | このポートグループを使用するポートのVLAN IDを指定します。以下の値が有効です。0 - ポートグループと VLAN を関連付けないことを指定します。1 ~ 4094 - ポートグループの VLAN ID を指定します。4095 - ポートグループがトランクモードを使用することを指定します。トランクモードでは、ゲスト OS が独自の VLAN タグを管理できます。 |
2-14.ポートグループセキュリティ確認
- 説明
このコマンドレットは、仮想ポート グループのセキュリティ ポリシー、または仮想スイッチのデフォルトのポート セキュリティ ポリシーを取得します。
- 書式
Get-SecurityPolicy -VirtualPortGroup <VirtualPortGroup[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例:vmk0 のMTUを変更する場合
Get-VirtualPortGroup "PortGroup名" | Get-SecurityPolicy
- オプション説明
オプション名 | 説名 |
VirtualPortGroup | セキュリティポリシーを取得する仮想ポートグループを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-15.ポートグループセキュリティ設定
- 説明
このコマンドレットは、指定された NIC チーミング ポリシーを変更します。ロード バランシングやフェイルオーバーの設定を変更することができます。デフォルトの NIC チーミング ポリシーは仮想スイッチ全体に設定され、ポート グループ レベルで上書きすることができます。
※ 基本的にはスイッチの場合と同じ、コマンド例では「Get-VirtualPortgroup」がスイッチの場合と違います。
- 書式
Set-SecurityPolicy -VirtualPortGroupPolicy <VirtualPortgroupSecurityPolicy[]> [-AllowPromiscuous <Boolean>] [-AllowPromiscuousInherited <Boolean>] [-ForgedTransmits <Boolean>] [-ForgedTransmitsInherited <Boolean>] [-MacChanges <Boolean>] [-MacChangesInherited <Boolean>] [CommonParameters]
- コマンド例:無差別モード(無効)、MAC アドレス変更(有効)、偽装転送(有効)にする場合
Get-VirtualPortgroup -Name "vSwitch0" | Get-SecurityPolicy | Set-SecurityPolicy -AllowPromiscuous:$false -ForgedTransmits:$true -MacChanges:$true -ForgedTransmitsInherited:$false
- オプション説明
オプション名 | 説名 |
VirtualPortGroupPolicy | 設定する仮想ポートグループのセキュリティポリシーを指定します。 |
AllowPromiscuous | 対応する仮想ポートグループまたはスイッチでプロミスキャスモードを有効にするかどうかを指定します。 |
AllowPromiscuousInherited |
AllowPromiscuousの設定を親仮想スイッチから引き継ぐかどうかを指定します。 |
ForgedTransmits | 対応する仮想ポートグループまたはスイッチでフォージドトランジットを有効にするかどうかを指定します。 |
ForgedTransmitsInherited | ForgedTransmitsの設定を親仮想スイッチから引き継ぐかどうかを指定します。 |
MacChanges | 対応する仮想ポートグループまたはスイッチでMACアドレスの変更を有効にするかどうかを指定します。 |
MacChangesInherited | MacChangesの設定を親仮想スイッチから引き継ぐかどうかを指定します。 |
2-16.ポートグループチーミング確認
- 説明
このコマンドレットは、仮想マシン ホストに関連する、または仮想マシンが使用する仮想スイッチを取得します。VMHost および VM パラメーターの少なくとも 1 つを提供する必要があります。VM、VMHost、Name パラメーターは、衝突のため、パイプラインを介した文字列値を受け付けません。デフォルトのサーバーと異なるサーバーを指定する場合は、Server パラメーターを使用します。
※ 基本的にはスイッチの場合と同じ、コマンド例では「Get-VirtualPortgroup」がスイッチの場合と違います。
- 書式
Get-NicTeamingPolicy -VirtualPortGroup <VirtualPortGroup[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Get-VirtualPortGroup | Get-NicTeamingPolicy | Sort VirtualPortGroup
- オプション説明
オプション名 | 説名 |
VirtualPortGroup | セキュリティポリシーを取得する仮想ポートグループを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-17.ポートグループチーミング設定
- 説明
このコマンドレットは、指定された NIC チーミング ポリシーを変更します。ロード バランシングやフェイルオーバーの設定を変更することができます。デフォルトの NIC チーミング ポリシーは仮想スイッチ全体に設定され、ポート グループ レベルで上書きすることができます。
- 書式
Set-NicTeamingPolicy -VirtualPortGroupPolicy <NicTeamingVirtualPortGroupPolicy[]> [-FailbackEnabled <Boolean>] [-InheritFailback <Boolean>] [-InheritFailoverOrder <Boolean>] [-InheritLoadBalancingPolicy <Boolean>] [-InheritNetworkFailoverDetectionPolicy <Boolean>] [-InheritNotifySwitches <Boolean>] [-LoadBalancingPolicy <LoadBalancingPolicy>] [-MakeNicActive <PhysicalNic[]>] [-MakeNicStandby <PhysicalNic[]>] [-MakeNicUnused <PhysicalNic[]>] [-NetworkFailoverDetectionPolicy <NetworkFailoverDetectionPolicy>] [-NotifySwitches <Boolean>] [CommonParameters]
- コマンド例:
# ”vmnic0” 要素を格納
$NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_0 = Get-VMHostNetworkAdapter -VMHost "IPAddress or hostname" -Physical -Name "vmnic0"
# ”vmnic1” 要素を格納
$NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_1 = Get-VMHostNetworkAdapter -VMHost "IPAddress or hostname" -Physical -Name "vmnic1"
#チーミングポリシー設定
Get-VirtualPortgroup -VirtualSwitch "vSwitch0" -Name "PortGroup名" | Get-NicTeamingPolicy | Set-NicTeamingPolicy -FailbackEnabled:$true -LoadBalancingPolicy "ExplicitFailover" -MakeNicActive $NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_0,$NETWORK_VSWITCH_VMNIC_ARRAY_ELEMENT_1 -NetworkFailoverDetectionPolicy "LinkStatus" -NotifySwitches:$false
オプション説明
オプション名 | 説名 |
VirtualPortGroupPolicy | 設定する仮想ポートグループポリシーを指定します。 |
FailbackEnabled | 物理アダプタが障害から回復した後にアクティブな状態に戻る方法を指定します。この値が $true の場合、アダプタは回復後すぐにアクティブに戻され、そのスロットを引き継いだスタンバイ・アダプタがある場合はその代わりとなります。この値が $false の場合、障害が発生したアダプタは回復してもアクティブなアダプタが故障して交換が必要になるまで非アクティブのままになります。 |
InheritFailback | FailbackEnabledパラメーターの値が仮想スイッチから継承されていることを示す。 |
InheritFailoverOrder | MakeNicActive、MakeNicStandBy、MakeNicUnusedパラメータの値が仮想スイッチから継承されることを示す。 |
InheritLoadBalancingPolicy | LoadBalancingPolicyパラメータの値が仮想スイッチから継承されていることを示す。 |
InheritNetworkFailoverDetectionPolicy | NetworkFailoverDetectionPolicyパラメータの値が仮想スイッチから継承されていることを示す。 |
InheritNotifySwitches | NotifySwitchesパラメータの値が仮想スイッチから継承されることを示す。 |
LoadBalancingPolicy |
スイッチに割り当てられたネットワークアダプタ間のネットワークトラフィックの分配方法を決定します。以下の値が有効です。 LoadBalanceIP - IPハッシュに基づいてルートを設定します。各パケットの送信元と送信先のIPアドレスのハッシュに基づいて、アップリンクを選択します。非 IP パケットの場合は、それらのオフセットにあるものがハッシュの計算に使用されます。 LoadBalanceSrcMac - ソースMACハッシュに基づいてルートを設定します。ソースイーサネットのハッシュに基づいてアップリンクを選択します。 LoadBalanceSrcId - 発信元のポートIDに基づいてルートを設定します。トラフィックが仮想スイッチに入った仮想ポートに基づいてアップリンクを選択します。 ExplicitFailover - アクティブなアダプタのリストから、フェイルオーバー検出基準に合格した最高順序のアップリンクを常に使用します。 |
MakeNicActive | ネットワークアダプターの接続が可能でアクティブな場合に、継続して使用するアダプターを指定します。 |
MakeNicStandby | アクティブなアダプタのいずれかの接続が利用できない場合に使用するアダプタを指定します。 |
MakeNicUnused | 使用しないアダプターを指定します。 |
NetworkFailoverDetectionPolicy |
アダプタの障害時にトラフィックを再ルーティングする方法を指定します。以下の値が有効です。 LinkStatus - ネットワークアダプタが提供するリンクステータスにのみ依存します。このオプションは、ケーブルの引き抜きや物理スイッチの電源障害などの障害を検出しますが、物理スイッチのポートがスパニングツリーによってブロックされたり、誤ったVLANに設定されていたり、物理スイッチの反対側でケーブルが引き抜かれたりするような構成エラーは検出しません。 BeaconProbing - チーム内のすべてのNICにビーコンプローブを送信して聞き取りを行い、リンクステータスに加えてこの情報を使用してリンク障害を判断します。このオプションは、リンクステータスだけでは検出できない上述の障害の多くを検出します。 |
NotifySwitches | 仮想スイッチに仮想NICが接続されたとき、またはフェイルオーバーイベントによりその仮想NICのトラフィックがチーム内の異なる物理NICを経由してルーティングされたときに、物理スイッチのルックアップテーブルを更新するための通知がネットワーク経由で送信されることを示します。 |
2-18.vmkernel 確認
- 説明
このコマンドレットは、vCenter Server システム上のホスト ネットワークを取得します。このコマンドは、VMHost パラメーターで指定されたホストのネットワーク構成を取得します。既定のサーバーとは異なるサーバーを指定するには、Server パラメーターを使用します。
- 書式
Get-VMHostNetwork -VMHost <VMHost[]> [-Server <VIServer[]>]
- コマンド例
# IPv4
Get-VMHostNetworkAdapter -VMKernel | select Name, DhcpEnabled,IP, SubnetMask | Format-List
# IPv6
Get-VMHostNetworkAdapter -VMKernel | select Name, IPv6Enabled,IPv6,IPv6ThroughDhcp | Format-List
- オプション説明
オプション名 | 説明 |
VMHost | ネットワーク設定を取得したいホストを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-19.vmkernel 作成
- 説明
このコマンドレットは、指定された仮想ネットワークを更新します。サービス コンソールと VM カーネルは同じネットワークに接続されていないことが多く、そのためそれぞれが独自のゲートウェイ情報を必要とします。ゲートウェイは、サービス コンソールや VM カーネルと同じ IP サブネット上にないマシンへの接続に必要です。
- 書式
Set-VMHostNetwork -Network <VMHostNetworkInfo[]> [-ConsoleGateway <String>] [-ConsoleGatewayDevice <String>] [-ConsoleV6Gateway <String>] [-ConsoleV6GatewayDevice <String>] [-DnsAddress <String[]>] [-DnsDhcpDevice <Object>] [-DnsFromDhcp <Boolean>] [-DomainName <String>] [-HostName <String>] [-IPv6Enabled <Boolean>] [-SearchDomain <String[]>] [-VMKernelGateway <String>] [-VMKernelGatewayDevice <String>] [-VMKernelV6Gateway <String>] [-VMKernelV6GatewayDevice <String>] [CommonParameters]
- コマンド例:VMKを作成し"MTU"の設定と "vMotion" をon にする場合
Get-VMHostNetworkAdapter -Name $NETWORK_VMK0_NAME | Set-VMHostNetworkAdapter -Mtu $NETWORK_VMK0_MTU -ManagementTrafficEnabled:$true
オプション名 | 説名 |
Network | 設定したいホストネットワークを指定します。 |
ConsoleGateway | 新しいコンソールゲートウェイを指定します。 |
ConsoleGatewayDevice |
新しいコンソールゲートウェイデバイスを指定します。 |
ConsoleV6Gateway | コンソールV6のゲートウェイアドレスを指定します。ESXiではサポートされていません。 |
ConsoleV6GatewayDevice | コンソールV6ゲートウェイデバイスを指定します。ESXiではサポートされていません。 |
DnsAddress | 新しいDNSアドレスを指定します。 |
DnsDhcpDevice | このパラメータは、DnsFromDhcpパラメータの値が「true」の場合は必須です。それ以外の場合は、無視されます。DnsDhcpDevice パラメーターが設定されている場合、サービスコンソールまたは VMKernel ネットワークアダプターの Dhcp DNS がシステム DNS より優先されます。このパラメータには、ServiceConsoleNIC オブジェクト、ESX visor の場合は VMKernelNIC オブジェクト、または文字列としての NIC 名が渡されます。 |
DnsFromDhcp | Dhcpサーバーからネットワーク設定を取得することを示します。 |
DomainName | 新しいドメイン名を指定します。 |
HostName | 新しいホスト名を指定します。 |
IPv6Enabled | IPv6 構成が有効であることを示します。このパラメーターを$falseに設定すると、ConsoleV6Gateway、ConsoleV6GatewayDevice、およびVMKernelV6Gatewayパラメーターが無効になります。IPv6 は、vCenter 4.1 および ESX 4.1 以降でのみサポートされています。ESX で IPv6 を使用するには、IPv6 を有効にした後、ホストを再起動する必要があります。 |
SearchDomain | 新しい検索ドメインを指定します。 |
VMKernelGateway | 新しいカーネルゲートウェイを指定します。 |
VMKernelGatewayDevice | 新しいカーネル・ゲートウェイ・デバイスを指定します。 |
VMKernelV6Gateway | VMKernel V6 ゲートウェイアドレスを指定します。このパラメーターは、ESX ホストでのみサポートされています。 |
VMKernelV6GatewayDevice | VMKernel V6 ゲートウェイデバイスを指定します。このパラメーターは、ESX ホストでのみサポートされています。 |
2-20.vmkernel MTU確認
- 説明
このコマンドレットは、vCenter Server システム上のホスト ネットワーク アダプターを取得します。
- 書式
Get-VMHostNetworkAdapter [[-Name] <String[]>] [-Console] [-Id <String[]>] [-Physical] [-PortGroup <VirtualPortGroupBase[]>] [-Server <VIServer[]>] [-VMHost <VMHost[]>] [-VMKernel] [-VirtualSwitch <VirtualSwitchBase[]>] [CommonParameters]
- コマンド例:
Get-VMHostNetworkAdapter -VMKernel
オプション名 | 説名 |
Name | 取得したいホストネットワークアダプターの名前を指定します。このパラメータの位置は非推奨で、将来のリリースで変更される予定です。既存のスクリプトを今後のPowerCLIのバージョンで実行したときにエラーが発生しないように、パラメータを名前で指定してください。 |
Console | サービスコンソールの仮想ネットワークアダプターのみを取得したいことを示します。 |
Id | 取得したいホストネットワークアダプタのIDを指定します。注:Idパラメータに値のリストを指定した場合、返されるオブジェクトのIDは、そのリストに含まれる文字列値のうち、正確に1つと一致するものになります。 |
Physical | 物理的なネットワークアダプターのみを取得することを示します。 |
PortGroup | 取得したいネットワークアダプターが接続されているポートグループを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
VMHost | ネットワークアダプターを取得したいホストを指定します。このパラメータの位置は非推奨で、次のリリースで変更される可能性があります。 |
VMKernel | VMKernel仮想ネットワークアダプタのみを取得することを示します。 |
VirtualSwitch | 取得したいネットワークアダプターが接続されている仮想スイッチを指定します。このパラメータの位置は非推奨で、将来のリリースで変更される予定です。将来のPowerCLIバージョンで既存のスクリプトを実行する際にエラーが発生しないように、パラメータを名前で指定してください。 |
2-21.vmkernel MTU設定
- 説明
このコマンドレットは、指定されたホスト ネットワーク アダプターを設定します。物理的なNICの場合は、デュプレックスとビットレートの設定 (10、100、1000、10000) を変更することができます。通常の仮想 NIC では、IP アドレスとサブネット マスクを変更できます。コンソール用の仮想NICでは、IPとサブネットマスクを変更するか、DHCPモードを選択することができます。
- 書式
Set-VMHostNetworkAdapter -VirtualNic <HostVirtualNic[]> [-AutomaticIPv6 <Boolean>] [-Dhcp] [-FaultToleranceLoggingEnabled <Boolean>] [-IP <String>] [-IPv6 <String[]>] [-IPv6Enabled <Boolean>] [-IPv6ThroughDhcp <Boolean>] [-Mac <String>] [-ManagementTrafficEnabled <Boolean>] [-Mtu <Int32>] [-ProvisioningEnabled <Boolean>] [-SubnetMask <String>] [-VMotionEnabled <Boolean>] [-VSphereBackupNfcEnabled <Boolean>] [-VSphereReplicationEnabled <Boolean>] [-VSphereReplicationNfcEnabled <Boolean>] [-VsanTrafficEnabled <Boolean>] [CommonParameters]
- コマンド例:
Get-VMHostNetworkAdapter -Name vmk0 | Set-VMHostNetworkAdapter -Mtu 9000 -ManagementTrafficEnabled:$true
オプション名 | 説名 | |
VirtualNic | 設定したいホストネットワークアダプターのリストを入力します。 | |
AutomaticIPv6 | ルーター広告でIPv6アドレスを取得していることを示す。 |
|
Dhcp | ホストのネットワークアダプタがDhcpサーバを使用するかどうかを示します。このパラメータは、ESXiホストでのみ機能します。VMKernel アダプタの場合、Dhcp は ESX 4.1 以降でのみサポートされます。 | |
FaultToleranceLoggingEnabled | ネットワークアダプターがFault Tolerance(FT)のロギングに有効であることを示します。このパラメータは、ESX/vCenter Server 4.1以降でのみサポートされています。 | |
IP | ネットワークアダプターのIPアドレスをIPv4のドット表記で指定します。サブネットマスクが定義されていないNICの場合は、SubnetMaskパラメータも設定する必要があります。IPパラメータを指定しない場合、DHCPモードが有効になります。仮想NICを設定する場合のみ有効です。 | |
IPv6 | スタティックアドレスを以下の形式で指定します。/ を省略した場合は、デフォルトの64が使用されます。IPv6パラメータに値を指定すると、現在の設定が上書きされます。設定したスタティックIPアドレスをすべて消去するには、IPv6パラメータに空の配列を渡します。 | |
IPv6Enabled | IPv6 の設定が有効であることを示します。このパラメータを$falseに設定すると、すべてのIPv6関連パラメータが無効になります。true "の場合は、IPv6ThroughDhcp、AutomaticIPv6、およびIPv6パラメータのうち少なくとも1つに値を指定する必要があります。 | |
IPv6ThroughDhcp | IPv6アドレスをDHCPで取得していることを示す。 | |
Mac | 仮想ネットワークアダプターのメディアアクセスコントロール(MAC)アドレスを指定します。仮想NICを設定する場合のみ有効です。 | |
ManagementTrafficEnabled | 管理トラフィックに対してネットワークアダプターを有効にすることを示します。このパラメーターは、ESX/ESXi/vCenter Server 4.1以降でのみサポートされています。 | |
Mtu | MTUサイズを指定します。 | |
|
このネットワークアダプターでvSphere Provisioningが有効になっているかどうかを指定します。 | |
SubnetMask | NICのサブネットマスクを指定します。NICにあらかじめサブネットマスクが定義されている場合は、マスクを変更しない限り、IPアドレスの設定時にSubnetMaskパラメータを指定することは必須ではありません。仮想NICを設定する場合のみ有効です。 | |
VMotionEnabled | VMotionにバーチャルホスト/VMKernelネットワークアダプタを使用することを示します。 | |
VSphereBackupNfcEnabled | このネットワークアダプターでNFCによるバックアップを有効にするかどうかを指定します。このパラメータは、vSphere 7.0以降でサポートされています。 | |
VSphereReplicationEnabled | このネットワークアダプターでvSphere Replicationのトラフィックを有効にするかどうかを指定します。 | |
VSphereReplicationNfcEnabled | このネットワークアダプタでvSphere Replication Network File Copy(NFC)トラフィックを有効にするかどうかを指定します。 | |
VsanTrafficEnabled | このネットワークアダプタでVirtual SANトラフィックを有効にするかどうかを指定します。 |
2-22.NTP 確認
- 説明
このコマンドレットは、指定されたホスト上のNTPサーバーを取得します。
- 書式
Get-VMHostNtpServer -VMHost <VMHost[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Get-VMHostNtpServer | ft -Auto
オプション名 | 説名 |
VMHost | NTPサーバーを取得したいホストを指定します。 |
Server | NTPサーバーを取得したいホストを指定してください。 値が提供されない場合、または $null 値がこのパラメーターに渡された場合、コマンドは既定のサーバーで実行されます。デフォルトのサーバーの詳細については、Connect-VIServer.antの説明を参照してください。 |
2-23.NTP 設定
- 説明
このコマンドレットは、指定されたホストの NTP サーバー リストに指定された NTP サーバーを追加します。サーバーがすでにリストにある場合は、終了しないエラーが生成され、複製は作成されません。
- 書式
Add-VMHostNtpServer [-VMHost] <VMHost[]> -NtpServer <String[]> [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Add-VMHostNtpServer -NTPServer ”IP Address”
オプション名 | 説名 |
VMHost | NTPサーバーを追加するホストを指定します。 |
NtpServer | ホストに追加するNTPサーバーのドメイン名またはIPアドレスを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-24.サービス確認
- 説明
このコマンドレットは、ホスト サービスに関する情報を取得します。Refresh パラメーターが $true に設定されている場合、コマンドレットは、ホスト サービスの情報を取得する前にリフレッシュします。既定のサーバーとは異なるサーバーを指定するには、Server パラメーターを使用します。
- 書式
Get-VMHostService -VMHost <VMHost[]> [-Refresh] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:NTP確認の場合
Get-VMHostService | ? { $_.Key -eq "ntpd"}
オプション名 | 説名 |
VMHost | 利用可能なサービスを取得したいホストを指定します。 |
Refresh | サービス情報を取得する前に、コマンドレットがサービス情報を更新するかどうかを示します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-25.サービス操作
- 説明
このコマンドレットは、ホスト サービスを変更します。
- 書式
Set-VMHostService [-Policy] <HostServicePolicy> -HostService <HostService[]> [CommonParameters]
- コマンド例:NTP サービスを有効にする場合
Get-VMHostService | ? { $_.Key -eq "ntpd"} | Set-VMHostService -Policy "on"
- オプション説明
オプション名 | 説名 |
Policy | ホストサービスのアクティベーションポリシーを指定します。 |
HostService | アップデートするホストサービスを指定します。 |
2-26.ファイアウォール確認
- 説明
このコマンドレットは、指定したホストのファイアウォール ポリシーから例外を取得します。例外は、VMHost、Name、Port、Enabled の各パラメーターを使用してフィルタリングできます。
- 書式
Get-VMHostFirewallException [-VMHost] <VMHost[]> [-Enabled <Boolean>] [-Name <String[]>] [-Port <Int32[]>] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:NTP クライアントを確認する場合
Get-VMHostFirewallException | ? {$_.Name -eq ("NTP Client")}
- オプション説明
オプション名 | 説名 |
VMHost | ファイアウォールの例外を取得するホストを指定します。 |
Enabled | 有効なホストのファイアウォール例外のみを取得するかどうかを示します。 |
Name | 取得したいファイアウォール例外の名前を指定します。 |
Port | ファイアウォールの例外を取得するポートの番号を指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
2-27.ファイアウォール操作
- 説明
このコマンドレットは、ホストのファイアウォール例外を有効または無効にします。
- 書式
Set-VMHostFirewallException [-Exception] <VMHostFirewallException[]> -Enabled <Boolean> [CommonParameters]
- コマンド例:NTPクライアントのFWを有効にする場合
Get-VMHostFirewallException | ? {$_.Name -eq ("NTP Client")} | Set-VMHostFirewallException -Enabled:$true
- オプション説明
オプション名 | 説名 |
Exception | 有効または無効にするファイアウォールの例外を指定します。 |
Enabled | 値が $true の場合、指定したファイアウォール例外が有効になります。値が$falseの場合、ファイアウォールの例外は無効になります。 |
3.ユーザ作成/権限変更
3-1.ユーザ確認
- 説明
このコマンドレットは、vCenter Server システムで利用可能なホスト アカウントを取得します。User および Group パラメーターの両方が $true に設定されている場合、コマンドによって返されるリストでは、グループ アカウントが最上位になります。User および Group スイッチ パラメーターのいずれも提供されない場合、コマンドレットはユーザー アカウントのみを取得します。ID パラメーターが設定されている場合、コマンドレットはホスト アカウントをその ID によってフィルタリングします。既定のサーバーとは異なるサーバーを指定するには、Server パラメーターを使用します。注意: 指定するサーバーは ESX/ESXi ホストでなければなりません。
- 書式
Get-VMHostAccount [-Group] [-Id <String[]>] [-Server <VIServer[]>] [-User] [CommonParameters]
- コマンド例:
Get-VMHostAccount -Server "IPAddress or hostname"
- オプション説明
オプション名 | 説名 |
Group | グループのホストアカウントのみを取得することを示します。ESXi 5.1以降、このパラメータはサポートされていません。 |
Id | 取得したいホストアカウントのIDを指定します。注:Idパラメータに値のリストを指定した場合、返されるオブジェクトのIDは、そのリストに含まれる文字列値のうち、正確に1つと一致するものになります。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
User | ユーザーのホストアカウントのみを取得したいことを示します。 |
3-2.ユーザ権限変更
- 説明
このコマンドレットは、提供されたパラメーターを使用して、新しいホスト ユーザーまたはグループ アカウントを作成します。
- 書式
New-VMHostAccount -Id <String> [-AssignUsers <String[]>] [-GroupAccount] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:追加ユーザにAdmin権限を入れる場合
New-VMHostAccount -Id "追加ユーザ名" -Password "追加ユーザパスワード"
- オプション説明
オプション名 | 説名 |
Password | 新しいホストアカウントのパスワードを指定します。 |
Id | 新しいホストアカウントのIDを指定します。 |
AssignGroups | UserAccount パラメーターが $true に設定されている場合は、AssignGroups を使用して、新しく作成されたユーザーが所属するグループを指定します。 |
Description | 新しいホストアカウントの説明を記入してください。文字数は最大255記号です。 |
GrantShellAccess | 新しいアカウントがESXシェルへのアクセスを許可されていることを示します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。パイプラインを介してこのパラメータに値を渡すことは非推奨であり、将来のリリースでは無効になる予定です。 |
UserAccount | 新しいホストアカウントがユーザーアカウントであることを示します。 |
3-3.ユーザ権限確認
- 説明
このコマンドレットは、指定されたインベントリ・オブジェクトに定義された権限を取得します。インベントリ・オブジェクトが指定されていない場合、このコマンドレットはサーバー上で利用可能なすべての権限を取得します。
- 書式
Get-VIPermission [-Entity <VIObject[]>] [-Principal <VIAccount[]>] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Get-VIPermission -Principal * -Server "IPAddress or hostname" | select *
- オプション説明
オプション名 | 説名 |
Entity | パーミッションを取得したいインベントリアイテムを指定します。 |
Principal | パーミッションを取得したいユーザーやグループを指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
3-4.ユーザ権限変更
- 説明
このコマンドレットは、ロール内の提供されたユーザーおよびグループに対して、指定されたインベントリ・オブジェクトの新しい権限を作成します。既定では、新しい権限は階層を下ってサブ・エンティティに伝搬されます。次のオブジェクトに対して新しい権限を作成することはできません: - データセンターの直接の子フォルダ - クラスタおよびスタンドアロン ホストのルート リソース プール。これらのオブジェクトは、常に親の権限を継承します。
- 書式
New-VIPermission [-Role] <Role> [-Entity] <VIObject> -Principal <VIAccount> [-Propagate <Boolean>] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
New-VIPermission -Entity (Get-VMHost) -Principal "ユーザID" -Role "権限" -Propagate:$true
- オプション説明
オプション名 | 説名 |
Role | 新しいパーミッションを作成するロールを指定します。 |
Entity | 新しいパーミッションを作成するインベントリ・オブジェクトを指定します。このパラメータに複数の値を渡すことは廃止されました。 |
Principal | 新しいパーミッションを適用するユーザーとグループを指定します。domain\name "という構文でプリンシパル名を指定した場合、ワイルドカードには対応していません。このパラメータに複数の値を渡すことは廃止されました。 |
Propagate | 新しいパーミッションを子インベントリオブジェクトに伝搬させることを示します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
4.ホスト-管理-詳細設定操作
4-1.ログ初期サイズ確認
- 説明
このコマンドレットは、指定されたエンティティの詳細設定を取得します。
- 書式
Get-AdvancedSetting [-Entity] <VIObject[]> [-Name <String[]>] [-Server <VIServer[]>] [CommonParameters]
- コマンド例:
Get-AdvancedSetting -Entity $SERVER_IPA -Name Syslog.global.defaultSize
オプション名 | 説名 |
Entity | 詳細設定を取得したいエンティティを指定します。VIServer、VirtualMachine、VMHost、DatastoreCluster、Clusterの各オブジェクトを指定します。 |
Name | 取得したい詳細設定の名前を指定します。 |
Server | cmdlet を実行する vCenter Server システムを指定します。値が指定されていない場合、またはこのパラメーターに $null 値が渡された場合、コマンドは既定のサーバーで実行されます。既定のサーバーの詳細については、Connect-VIServer の説明を参照してください。 |
4-2.ログ初期サイズ変更
- 説明
このコマンドレットは、指定された詳細設定を変更します。
- 書式
Set-AdvancedSetting [-AdvancedSetting] <AdvancedSetting[]> -Value <Object> [CommonParameters]
- コマンド例:Syslog.global.defaultSize を1024 から 10240 へ変更する場合
Get-AdvancedSetting -Entity ”IPAddress” -Name Syslog.global.defaultSize | Set-AdvancedSetting -Value 10240
オプション名 | 説名 |
AdvancedSetting | 変更したい詳細設定を指定します。 |
Value | 詳細設定の新しい値を指定します。 |