Get-SCDirectoryChildItem

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

语法

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

说明

Get-SCDirectoryChildItem cmdlet 在虚拟机主机上的指定目录下或由 Virtual Machine Manager 管理的库服务器上立即获取所有文件和子目录, (VMM) 。 如果指定共享路径 (,例如 \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变量中。

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

示例 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 库服务器对象。

Type:LibraryServer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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*"

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHost

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

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

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输出

VMHostFileInformation

此 cmdlet 返回 VMHostFileInformation 对象。