PowerShell Get-VHD“不是现有的虚拟硬盘文件”

在 Hyper-V 中创建新 VM 时，为了使事情井井有条，我在创建关联的 VHDX 文件时使用特定的命名约定。命名约定是 VM FQDN，后跟 SCSI 控制器连接点，后跟 VM 内部的驱动器名称或使用名称。我将 SCSI 和 Name 参数分别封装在圆括号和方括号内。我发现从人的角度来看，这往往会使事情变得更容易，将 Hyper-V 中的 VHDX 文件与需要执行维护任务时虚拟机内部看到的文件进行匹配。它在过去也有助于编写脚本。示例文件名如下所示...

servername.example.com(0-0)[OS].vhdx

这在相当长的一段时间内一直运行良好，但最近我尝试对 VHDX 文件运行一些 PowerShell 命令并遇到了问题。显然，内部 VM 名称的方括号被解析为 RegEx 或 PowerShell commandlet 内部的某些内容（老实说，我只是猜测这一点）。当我尝试对具有上述命名约定的文件使用 Get-VHD 时，它会抛出如下错误：

Get-VHD : 'E:\Hyper-V\servername.example.com\Virtual Hard Disks\servername.example.com(0-0)[OS].vhdx' is not an existing virtual hard disk file.
At line:1 char:12
+ $VhdPath | Get-VHD
+            ~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Get-VHD], VirtualizationException
    + FullyQualifiedErrorId : InvalidParameter,Microsoft.Vhd.PowerShell.Cmdlets.GetVHD

如果我只是重命名 VHDX 文件以排除命名约定的“[OS]”部分，则该命令可以正常工作。 SCSI 连接点的光滑支架似乎并没有打扰它。我尝试执行替换命令以在括号前面添加反引号“`”以转义它们，但会产生相同的错误。我还尝试过双反引号，看看传入反引号是否有帮助......这至少在它吐出的错误中显示了一个反引号。怀疑正则表达式，我也尝试将反斜杠作为转义字符...这具有将文件路径中的所有反斜杠转换为错误消息中的双反斜杠的有趣效果。我尝试通过单引号和双引号定义路径变量，但没有成功。我还尝试了几种通过管道获取它的不同方法，例如这个例子......

((Get-VM $ComputerName).HardDrives | Select -First 1).Path | Get-VHD

而且，就其价值而言，我尝试处理的虚拟机数量一样多......我需要能够通过管道或其他一些自动化脚本方法来运行它，而不是手动编码对每个 VHDX 文件的引用。

仍然认为这可能是 RegEx 的问题，我尝试使用以下命令转义变量字符串，但无济于事：

$VhdPathEscaped = [System.Text.RegularExpressions.Regex]::Escape($VhdPath)

坦白说，我没有想法。

当我第一次遇到这个问题时，我尝试使用 PowerShell 压缩 VHDX 文件。但是，由于我正在使用的单个虚拟机无论如何都需要离线才能运行该功能，所以我只是将其重命名、压缩，然后将名称重置回来，而不是使用 VHDX 名称来解决错误。然而，对于我现在尝试做的工作，我无法让虚拟机脱机，因为该脚本将针对整个实时虚拟机群运行。因此，我需要知道如何正确转义这些字符，以便 Get-VHD commandlet 接受这些文件名。

tl;dr:

• A 设计限制 of Get-VHD https://learn.microsoft.com/en-us/powershell/module/hyper-v/get-vhd阻止它正确识别 VHD包含的路径[ and ]（有关详细信息，请参阅底部部分）。

• 解决方法：使用short(8.3) 文件路径假设文件系统支持它们:

$fso = New-Object -ComObject Scripting.FileSystemObject

$VhdPath | 
  ForEach-Object { $fso.GetFile((Convert-Path -LiteralPath $_)) } | 
    Get-VHD

• 否则，您唯一的选择是（正如您所报告的，在您的情况下，VHD 位于ReFS文件系统 https://en.wikipedia.org/wiki/ReFS，这确实not支持短名称）：

  • Rename你的文件（和文件夹，如果适用）不包含[ or ].

  • 或者，如果您可以假设您的 VHD 是连接到虚拟机，您可以提供VM兴趣的 VHD 作为输入附加到Get-VHD, via Get-VM https://learn.microsoft.com/en-us/powershell/module/hyper-v/get-vm（您可能必须将输出过滤为仅包含感兴趣的 VHD）：

    (Get-VM $vmName).Id | Get-VHD
    

背景资料:

看起来像Get-VHD https://learn.microsoft.com/en-us/powershell/module/hyper-v/get-vhd只有一个-Path范围，不也是一个-LiteralPath参数，看起来像是一个设计缺陷：

Having both参数通常用于文件处理 cmdlet（例如Get-ChildItem):

• -Path接受通配符表达式 https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_Wildcards通过 a 匹配可能的多个文件pattern.

• -LiteralPath用于传递literal（逐字）路径，按原样使用。

What you have is a literal path that happens to look like a wildcard expression, due to use of metacharacters [ and ]. In wildcard contexts, these metacharacter must normally be escaped - as `[ and `] - in order to be treated as literals, which the following (regex-based) -replace https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_Comparison_Operators#replacement-operator operation ensures^[1] (even with arrays as input).

• 不幸的是，这appears not足以Get-VHD.（尽管您可以通过管道来验证它原则上是否有效Get-Item相反，它也绑定到-Path).

  • Even double `- 转义（-replace '[][]', '``$&'）不起作用（这是 - 在某些情况下意外需要 - 请参阅GitHub 问题 #7999 https://github.com/PowerShell/PowerShell/issues/7999).

# !! SHOULD work, but DOES NOT
# !! Ditto for -replace '[][]', '``$&'
$VhdPath -replace '[][]', '`$&' | Get-VHD

Note: Normally, a robust way to ensure that a cmdlet's -LiteralPath parameter is bound by pipeline input is to pipe the output from Get-ChildItem or Get-Item to it.^[2] Given that Get-VHD lacks -LiteralPath, this is not an option, however:

# !! DOES NOT HELP, because Get-VHD has no -LiteralPath parameter.
Get-Item -LiteralPath $VhdPath | Get-VHD

^{[1] See this regex101.com page https://regex101.com/r/OxqUnx/1 for an explanation of the regex ($0 is an alias of $& and refers to the text captured by the match at hand, i.e. either [ or ]). Alternatively, you could pass all paths individually to the [WildcardPattern]::Escape() method (e.g., [WildcardPattern]::Escape('a[0].txt') yields a`[0`].txt.}

^{[2] See this answer https://stackoverflow.com/a/60177977/45375 for the specifics of how this binding, which happens via the provider-supplied .PSPath property, works.}