VMware PowerCLI 12.1.0 がリリースされました

2020/10/13 (現地時間) に VMware PowerCLI の最新版である VMware PowerCLI12.1.0 がリリースされた旨のアナウンスがありました。

New Release PowerCLI 12.1- vLCM Enhancements

Introducting PowerCLI 12.1 which now supports vSphere Lifecycle Manager (vLCM). Having vLCM capabilities delivered via P...

blogs.vmware.com

VMware PowerCLI 12.1.0 の変更点やユーザーガイドなどについては、以下 VMware サイトにリンクが纏められています。

- VMware {Code} Community

The site home page

code.vmware.com

VMware PowerCLI 12.1.0 のインストールについては、PowerShell Gallery 経由から可能となっています。

VMware.PowerCLI 12.1.0.17009493

This Windows PowerShell module contains VMware.PowerCLI

powershellgallery.com

なお、Hyper-V の機能がインストールされている環境の場合、以下のエラーメッセージ (コマンドレットが重複する) が表示されるため、注意が必要です。

VMware PowerCLI 12.1.0 におけるアップデート内容 (意訳)

機能の追加

• ワークロード管理クラスターを管理するための新しいコマンドレットが VMware.VimAutomation.WorkloadManagement モジュールに追加されました :
  • Get-WMCluster
  • Set-WMCluster
  • Enable-WMCluster
  • Disable-WMCluster
• vSphere Lifecycle Manager の新しいコマンドレットが VMware.VimAutomation.Core モジュールに追加されました :
  • Get-LcmImage
  • Test-LcmClusterCompliance
  • Test-LcmClusterHealth
• クラスターの EDRS ポリシーを指定するための新しいコマンドレットが VMware.VimAutomation.Vmc モジュールに追加されました :
  • Get-VmcClusterEdrsPolicy
  • Set-VmcClusterEdrsPolicy
• vSAN セキュア ディスク ワイプを管理するための新しいコマンドレットが VMware.VimAutomation.Storage モジュールに追加されました :
  • Start-VsanWipeVsanDisk
  • Get-VsanWipeDiskState
  • Stop-VsanWipeVsanDisk
• Cloud Native Storage ボリュームを管理するための新しいコマンドレットが VMware.VimAutomation.Storage モジュールに追加されました :
  • Get/New/Set/Remove-CnsVolume
  • New-CnsContainerCluster
  • New-CnsKubernetesEntityReference
  • New-CnsKubernetesEntityMetadata
  • New-CnsVolumeMetadata
  • Add-CnsAttachment
  • Remove-CnsAttachment
• Virtual Volume (vVol) ストレージ コンテナーを管理するための新しいコマンドレットが VMware.VimAutomation.Storage モジュールに追加されました :
  • Get-VvolStorageContainer
• VMware Cloud Services サーバーから切断できるように、Disconnect-Vcs コマンドレットが VMware.CloudServices モジュールに追加されました。

修正

• BaseImage および VendorAddOn パラメーターが New-Cluster および Set-Cluster コマンドレットに追加され、クラスター内の ESXi ホストのベース イメージおよびベンダーア ドオンを指定できるようになりました。
• コンポーネント パラメーターが Set-Cluster コマンドレットに追加され、クラスターのホストが準拠する必要のある ESXi コンポーネントを指定できるようになりました。
• Remediate および AcceptEULA パラメーターが Set-Cluster コマンドレットに追加され、クラスター ホストをターゲット状態に修復できるようになりました。
• Uri、FileName、および SslThumbprint パラメーターが New-ContentLibraryItem コマンドレットに追加され、インターネットもしくはデータストアの URL からファイルをアップロードできるようになりました。
• ItemType パラメーターが New-ContentLibraryItem および Set-ContentLibraryItem コマンドレットに追加され、コンテンツ ライブラリ アイテムのタイプを指定できるようになりました。
• SEVEnabled パラメーターが New-VM および Set-VM コマンドレットに追加され、Secure EncryptedVirtualization 機能を有効にできるようになりました。
• VvolStorageContainer パラメーターが New-Datastore コマンドレットに追加され、仮想ボリューム (vVol) データストアを作成できるようになりました。
• New-HardDisk コマンドレットの DiskType パラメーターは、Persistent Memory (PMem) ディスク タイプをサポートするように拡張されました。
• 不透明なネットワークの Get-NetworkAdapter および Get-VirtualNetwork コマンドレットのパフォーマンスが改善されました。
• Set-ScsiLun コマンドレットの NoCommandsSwitch および NoBlocksSwitch パラメーターは、ESXi7.0 以降に対してコマンドレットを使用する場合は非推奨になりました。
• SddcAppliancesSize パラメーターが New-VmcSddc コマンドレットに追加され、SDDC アプライアンスのサイズを指定できるようになりました。 SDDC アプライアンスのサイズは、中規模および大規模にすることができます。デフォルト値は中です。
• StretchedCluster パラメーターが New-VmcSddc コマンドレットに追加され、SDDC を 2 つのアベイラビリティ ゾーンに拡張できるようになりました。
• HostType パラメーターが New-VmcSddc コマンドレットに追加され、ホスト タイプを指定できるようになりました。サポートされているホスト タイプは i3 と i3en です。
• Add-VmcSddcHost コマンドレットに Cluster パラメーターが追加され、特定のクラスターにホストを追加できるようになりました。
• Cluster パラメーターが Remove-VmcSddcHost コマンドレットに追加され、特定のクラスターからホストを削除できるようになりました。
• Connect-VIServer コマンドレットを使用する場合に、SDDC に簡単に接続できるように、VCenterHostName プロパティと VCenterCredentials プロパティが SDDC オブジェクトに追加されました。
• Set-VsanClusterConfiguration および Get-VsanClusterConfiguration コマンドレットが拡張され、vSAN 圧縮のみモードをサポートし、vSAN が容量予約を実施します。
• Get-VsanSpaceUsage コマンドレットが改善され、スラック スペース関連の内訳が返されるようになりました。
• Get-VasaArray および Get-VasaProvider コマンドレットが改善され、取得した VASA プロバイダーを vVol ストレージ コンテナーでフィルター処理できるようになりました。
• 新しい Get-TrustedClusterAppliedStatus コマンドレットが VMware.VimAutomation.Security モジュールに追加され、信頼できるクラスター上の信頼できるサービス情報の適用ステータスを取得する機能を提供します。
• Set-TrustedCluster コマンドレットが改善され、ワー​​クロード vCenterServer システムで適用されたステータスが正常でない場合にクラスターが自動的に修正されるようになりました。
• MasterKeyId パラメーターは廃止され、New-TrustAuthorityKeyProvider および Set-TrustAuthorityKeyProvider コマンドレットの PrimaryKeyId パラメーターに置き換えられました。
• サーバー パラメーターが Set-TrustAuthorityTpm2AttestationSettings コマンドレットに追加されました。
• Add-TrustedClusterAttestationServiceInfo、Add-TrustedClusterKeyProviderServiceInfo、Remove-TrustedClusterKeyProviderServiceInfo、および Remove-TrustedClusterAttestationServiceInfo コマンドレットが改善され、信頼できるクラスターの適用ステータスが正常でない場合に警告メッセージが表示されるようになりました。
• VMware.VimAutomation.Srm モジュールがアップデートされ、VMware Site Recovery Manager8.3.1 がサポートされるようになりました。
• VMware.VimAutomation.Horizo​​nView モジュールがアップデートされ、VMware Horizo​​n7 バージョン 7.13 がサポートされるようになりました。
• VMware.VimAutomation.Hcx モジュールがアップデートされ、VMware CloudDirector が HCXOS アシスト移行のターゲットとして構成されました。
• Wait-HCXJob コマンドレットが改善され、Update-HCXSentinel コマンドレットのステータスを取得できるようになりました。
• VMware.Vim モジュールがアップデートされ、vSphere 7.0 Update1 の API バインディングが含まれるようになりました。

不具合修正

• Get-HCXMigration
  • Get-HCXMigration を使用する場合、移行の進行状況のパーセンテージは 0 を示していました。
• Get-HCXNetwork
  • Get-HCXNetwork を実行している場合、PowerCLI は OpaqueNetwork ネットワーク タイプを認識しませんでした。
• Get-OvfConfiguration
  • Get-OvfConfiguration は、”.” が含まれている場合、完全なネットワーク名を表示しませんでした。
• Get-SpbmCapability
  • Get-SpbmCapability を実行すると、PowerCLI は System.Array 型の機能を正しく解釈しませんでした。
• Get-VMHostHardware
  • 一部の ESXi ホストで Get-VMHostHardware を使用すると、PowerShell プロセスが失敗しました。
• Move-VM
  • vSphere 6.7 以降に対して Move-VM を実行する場合、仮想マシンをフォルダーの移動先に移動することはできませんでした。
  • PowerCLI を用いて CrossvCenter vMotion を実行すると、オブジェクト参照タイプがオブジェクト インスタンスに設定されていないというエラー メッセージが表示されました。
  • 電源がオフになっている仮想マシンをフォルダーに移動しようとすると、操作が失敗し、次のタイプのメッセージが表示されました : Unable to access the virtual machine configuration: Unable to access file.
• New-HCXMigration
  • 移行先サイトが VMwareCloud Director の場合、HCXOS 支援移行をトリガーすることはできませんでした。
• New-NetworkAdapter
  • 一部のゲスト オペレーティング システムで New-NetworkAdapter を使用する場合、コマンドレットは Type パラメーターを尊重せず、常に Vmxnet ネットワーク アダプターを作成していました。
• Remediate-Inventory
  • Remediate-Inventoryを実行すると、操作は次のタイプのメッセージで失敗しまました : ”registry.proxy.’ is invalid or exceeds the maximum number of characters permitted’.
• Set-DrsClusterGroup
  • Set-DrsClusterGroup を用いる場合、空の DRS グループに仮想マシンを追加することはできませんでした。
• Set-DRSRule
  • 異なるサーバーから複数の DRS ルールを更新し、異なるサーバーで同じ ID を持つ仮想マシンを指定しようとすると、エラー メッセージが表示され、プロセスが失敗していました。
• Update-Entity
  • Update-Entity を実行すると、操作は ”registry.proxy.’ is invalid or exceeds the maximum number of characters permitted’. タイプのメッセージで失敗しました。
• Update-VmfsDatastore
  • Update-VmfsDatastore コマンドレットを用いて VMFS5 データストアを VMFS6 にアップグレードする際、タイプ item のエラー メッセージがすでに追加されていました。辞書のキーが表示されます。

モジュールのアンインストールについて

以下のコマンドを実行することで、PowerCLI 12.0.0 と同様にインストールされた PowerCLI 12.1.0 のモジュールをすべて削除することが可能です。

参考

• VMware PowerCLI Blog – PowerCLI is the best tool for automating management and configuration of VMware vSphere – VMware Blogs
  https://blogs.vmware.com/PowerCLI/
• VMware PowerCLI Documentation
  https://www.vmware.com/support/developer/PowerCLI/
• PowerShell Gallery | Home
  https://www.powershellgallery.com/