Get-SCDirectoryChildItem

Obtiene todos los archivos y subdirectorios del directorio especificado en un host de máquina virtual o en un servidor de biblioteca administrado por VMM.

Sintaxis

FromVMHost

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

FromLibraryServer

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

Description

El cmdlet Get-SCDirectoryChildItem obtiene todos los archivos y subdirectorios inmediatamente bajo el directorio especificado en un host de máquina virtual o en un servidor de biblioteca administrado por Virtual Machine Manager (VMM). Si especifica una ruta de acceso de recurso compartido (como \ServerName\ShareName\Directory\FileName), se devuelven los subdirectorios de la ruta de acceso de uso compartido.

Si usa el cmdlet Get-SCDirectoryChildItem para recuperar archivos y subdirectorios en un servidor de biblioteca, debe especificar una ruta de acceso a un recurso compartido de biblioteca válido. Por ejemplo, la ruta de acceso al recurso compartido de biblioteca predeterminada instalado por el programa de instalación al instalar VMM por primera vez es: \VMMServerName.DomainName.com\MSSCVMMLibrary

Ejemplos

Ejemplo 1: Obtención de los archivos y subdirectorios de la ruta de acceso especificada en un host VMM

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

El primer comando obtiene el objeto host denominado VMHost01 de la base de datos VMM y almacena el objeto en la variable $VMHost.

El segundo comando muestra el nombre y otra información sobre cada archivo y subdirectorio inmediatamente debajo de la unidad C:\ en VMHost01.

Ejemplo 2: Obtener los subdirectorios de la ruta especificada en un servidor de biblioteca

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

El primer comando obtiene el objeto de servidor de biblioteca denominado FileServer01 de VMMServer01 y almacena el objeto en la variable $LibServ.

El segundo comando muestra el nombre, el directorio primario y otra información sobre cada archivo almacenado en el directorio para el recurso compartido de biblioteca predeterminado en FileServer01. Debe especificar la ruta de acceso completa al recurso compartido de biblioteca.

Nota: En este ejemplo se supone que se usa el recurso compartido de biblioteca VMM predeterminado (MSSCVMMLibrary) en su entorno. Para obtener los nombres de los recursos compartidos de biblioteca, escriba Get-SCLibraryShare | Select Name.

Parámetros

-LibraryServer

Especifica un objeto de servidor de biblioteca VMM.

Propiedades del parámetro

Tipo:LibraryServer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromLibraryServer
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Path

Especifica la ruta de destino de la operación.

Formatos de ejemplo:

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

Este parámetro acepta caracteres comodín para una ruta de acceso UNC.

Formato de ejemplo:

Ruta UNC: -Path "\\VMHostServer\MyVMs\*VM*"

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VMHost

Especifica un objeto host de máquina virtual. VMM admite hosts Hyper-V, hosts VMware ESX y hosts Citrix XenServer.

Para obtener más información sobre cada tipo de host, consulte el cmdlet Add-SCVMHost .

Propiedades del parámetro

Tipo:Host
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromVMHost
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

VMHostFileInformation

Este cmdlet devuelve un objeto VMHostFileInformation .