Get-SCDirectoryChildItem

获取虚拟机主机或 VMM 管理的库服务器上的指定目录中的所有文件和子目录。

语法

Get-SCDirectoryChildItem
   -VMHost <Host>
   -Path <String>
   [<CommonParameters>]
Get-SCDirectoryChildItem
   -LibraryServer <LibraryServer>
   -Path <String>
   [<CommonParameters>]

说明

Get-SCDirectoryChildItem cmdlet 将立即获取虚拟机主机或由 Virtual Machine Manager 管理的库服务器上指定目录下的所有文件和子目录。 如果指定共享路径(如 \ServerName\ShareName\Directory\FileName),则返回共享路径的子目录。

如果使用 Get-SCDirectoryChildItem cmdlet 检索库服务器上的文件和子目录,则必须指定有效库共享的路径。 例如,首次安装 VMM 时安装程序安装的默认库共享的共享路径为:\VMMServerName.DomainName.com\MSSCVMMLibrary

示例

示例 1:获取 VMM 主机上指定路径的文件和子目录

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Get-SCDirectoryChildItem -VMHost $VMHost -Path "C:\"

第一个命令从 VMM 数据库获取名为 VMHost01 的主机对象,并将该对象存储在$VMHost变量中。

第二个命令显示 VMHost01 上的 C:\ 驱动器下每个文件和子目录的名称和其他信息。

示例 2:获取库服务器上的指定路径的子目录

PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "FileServer01.Contoso.com"
PS C:\> Get-SCDirectoryChildItem -LibraryServer $LibServ -Path "\\FileServer01.Contoso.com\MSSCVMMLibrary"

第一个命令从 VMMServer01 获取名为 FileServer01 的库服务器对象,并将该对象存储在$LibServ变量中。

第二个命令显示有关 FileServer01 上默认库共享目录中存储的每个文件的名称、父目录和其他信息。 必须指定库共享的完整路径。

注意:此示例假定环境中使用了默认 VMM 库共享(MSSCVMMLibrary)。 若要获取库共享的名称,请键入 Get-SCLibraryShare | Select Name

参数

-LibraryServer

指定 VMM 库服务器对象。

类型:LibraryServer
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Path

指定操作的目标路径。

示例格式:

  • 本地路径:-Path "F:\"
  • UNC 路径:-Path "\\Library\Templates"
  • 卷 GUID 路径:-Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX 路径:-Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer 路径:-Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"

此参数接受 UNC 路径的通配符。

示例格式:

UNC 路径:-Path "\\VMHostServer\MyVMs\*VM*"

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-VMHost

指定虚拟机主机对象。 VMM 支持 Hyper-V 主机、VMware ESX 主机和 Citrix XenServer 主机。

有关每种主机类型的详细信息,请参阅 Add-SCVMHost cmdlet。

类型:Host
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

输出

VMHostFileInformation

此 cmdlet 返回 VMHostFileInformation 对象。